Objects

Create a company

Create a company in the tenant and project derived from the access token.

Overview

Use this endpoint to create a company with one or more properties. You can optionally create initial associations to existing records in the same request. It requires public api oauth access token authentication and the crm.companies.write scope.

POST/api/objects/companies

cURL

POST

bash

curl --request POST \  --url 'https://crm.notifyy.io/api/objects/companies' \  --header 'Authorization: Bearer nfy_public_api_access_token' \  --header 'Content-Type: application/json' \  --data '{  "properties": [    {      "internal_name": "name",      "value": "Notifyy"    },    {      "internal_name": "domain",      "value": "notifyy.io"    }  ],  "associations": [    {      "to": {        "object": "contact",        "id": "456"      }    },    {      "to": {        "object": "deal",        "id": "789"      }    }  ]}'

Authorization

Public API OAuth access token

crm.companies.write

Sample Request Body

json

{  "properties": [    {      "internal_name": "name",      "value": "Notifyy"    },    {      "internal_name": "domain",      "value": "notifyy.io"    }  ],  "associations": [    {      "to": {        "object": "contact",        "id": "456"      }    },    {      "to": {        "object": "deal",        "id": "789"      }    }  ]}

Sample Response

json

{  "success": true,  "message": "Company created successfully",  "data": {    "id": 999,    "name": "Notifyy",    "domain": "notifyy.io",    "website": null,    "lifecyclestage": null,    "createdAt": "2026-07-31T10:15:30Z",    "updatedAt": "2026-07-31T10:15:30Z"  }}

Status Codes

Code	Description
201	Company was created.

Headers

AuthorizationstringRequired

Public API OAuth bearer token.

Example: Bearer nfy_public_api_access_token

Content-TypestringRequired

Request body media type.

Example: application/json

Object	Description
Authorization string	RequiredPublic API OAuth bearer token. Example: Bearer nfy_public_api_access_token
Content-Type string	RequiredRequest body media type. Example: application/json

Request body

propertiesobject[]Required

Company properties to create. At least one property is required.

properties[].internal_namestringRequired

Internal property name. Forbidden internal fields such as cin and project_id are not allowed.

Example: name

properties[].valueanyOptional

Scalar property value.

Example: Notifyy

properties[].valuesarrayOptional

Multi-value property values.

associationsobject[]Optional

Associations to create along with the company.

associations[].to.objectstringRequired

Associated object type, such as contact or deal.

Example: contact

associations[].to.idstringRequired

Associated record ID. Must be numeric.

Example: 456

Object	Description
properties object[]	RequiredCompany properties to create. At least one property is required.
properties[].internal_name string	RequiredInternal property name. Forbidden internal fields such as cin and project_id are not allowed. Example: name
properties[].value any	OptionalScalar property value. Example: Notifyy
properties[].values array	OptionalMulti-value property values.
associations object[]	OptionalAssociations to create along with the company.
associations[].to.object string	RequiredAssociated object type, such as contact or deal. Example: contact
associations[].to.id string	RequiredAssociated record ID. Must be numeric. Example: 456

Response fields

successboolean

Whether the request succeeded.

Example: true

messagestring

Human-readable result message.

Example: Company created successfully

data.idinteger

Company record ID.

Example: 999

data.namestring | null

Company name.

Example: Notifyy

data.domainstring | null

Company domain.

Example: notifyy.io

data.websitestring | null

Company website.

data.lifecyclestagestring | null

Lifecycle stage property value.

data.createdAtstring<date-time>

Creation timestamp.

Example: 2026-07-31T10:15:30Z

data.updatedAtstring<date-time>

Last update timestamp.

Example: 2026-07-31T10:15:30Z

Object	Description
success boolean	Whether the request succeeded. Example: true
message string	Human-readable result message. Example: Company created successfully
data.id integer	Company record ID. Example: 999
data.name string \| null	Company name. Example: Notifyy
data.domain string \| null	Company domain. Example: notifyy.io
data.website string \| null	Company website.
data.lifecyclestage string \| null	Lifecycle stage property value.
data.createdAt string<date-time>	Creation timestamp. Example: 2026-07-31T10:15:30Z
data.updatedAt string<date-time>	Last update timestamp. Example: 2026-07-31T10:15:30Z