Hanzo
OpenapiCrm

Adds a company to the caller's org and answers 201 with the stored record.

Adds a company to the caller's org and answers 201 with the stored record.

POST /v1/crm/companies

Addresshttps://api.hanzo.ai/v1/crm/companies
MethodPOST
Operationpost_crm_companies
AuthAuthorization: Bearer $HANZO_API_KEY

Adds a company to the caller's org and answers 201 with the stored record. A name is required; an empty currency defaults to USD.

Request

11 fields, body application/json (required).

FieldInTypeRequiredDescription
arrbodyintegerARR is annual recurring revenue in minor units (cents) of Currency.
citybodystringCity is the head-office city.
countrybodystringCountry is the head-office country.
currencybodystringCurrency is the ISO code ARR is denominated in; empty defaults to USD.
domainNamebodystringDomainName is the company's primary domain, e.g.
employeesbodyintegerEmployees is the headcount.
idbodystringID names the company to update and comes from the path.
idealCustomerProfilebodybooleanICP marks the company as an ideal-customer-profile fit.
linkedinLinkbodystringLinkedin is the company's LinkedIn URL.
namebodystringName is the company name.
xLinkbodystringXLink is the company's X (Twitter) URL.

Response

StatusBodyMeaning
201Companycreated

201 body — 13 fields.

FieldInTypeAlwaysDescription
arrbodyintegerARR is annual recurring revenue in minor units (cents) of Currency.
citybodystringCity is the head-office city.
countrybodystringCountry is the head-office country.
createdAtbodyintegerCreatedAt is the unix second the company was created.
currencybodystringCurrency is the ISO code ARR is denominated in; a write that names none stores USD.
domainNamebodystringDomainName is the company's primary domain, e.g.
employeesbodyintegerEmployees is the headcount.
idbodystringID is the server-minted company id ("comp_" + 128 random bits).
idealCustomerProfilebodybooleanICP marks the company as an ideal-customer-profile fit.
linkedinLinkbodystringLinkedin is the company's LinkedIn URL.
namebodystringName is the company name.
updatedAtbodyintegerUpdatedAt is the unix second of the last write.
xLinkbodystringXLink is the company's X (Twitter) URL.

Failure carries the platform error shape — see Errors.

Examples

hanzo crm companies create

CRM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page