Creates a customer
Endpoint URL
https://{{base_url}}/api/v2/customer
Authentication and rate limits
Item | Details |
---|---|
Authentication method | OAuth 2.0 Bearer token |
Rate limit | Rate Limit |
Requests Example
curl --request POST \
--url 'https://{{base_url}}/api/v2/customer \
--header 'Authorization: Bearer $BEARER_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '$JSON'
Request Syntax
{
"company": integer,
"name": "string",
"category": integer,
"contact_person": {
"name": "string",
"email": "string",
"type": "account_management"|"billing"|"executive"|"sales"|"support"|"technical"
},
"address_line_1": "string",
"address_line_2": "string",
"city": "string",
"state_province": "string",
"zip_postal_code": "string",
"country": "string",
"phone": "string",
"mobile": "string",
"fax": "string",
"website": "string",
"general_description": "string",
"nda_signed": true|false,
"nda_signed_date": "string",
"msa_signed": true|false,
"msa_signed_date": "string",
"supplementary_description": "string",
"additional_description": "string",
"template":
{
"id": integer,
"fields": [
{
"id": integer,
"value": decimal | integer | "string"
},
]
}
}
Body Parameters
- company (integer) --
[REQUIRED]
The ID of the specific company your API is calling. For accounts with only one company, the default value is1
.
To lookup a specific company ID, see the List Company API. - name (string) --
[REQUIRED]
The name of the customer.
Max characters =50
The name of the customer must be unique per account. - category (integer) --
The ID of the category.
To lookup a specific category ID, see the List Category API. - contact_person (dict) --
- name (string) --
[REQUIRED] if
email
is defined
The name of the contact person.
Max characters =50
- email (string) --
[REQUIRED] if
name
is defined
The email of the contact person.
Max characters =254
- type (string) --
The type of the contact person.
Options:account_management
|billing
|executive
|sales
|support
|technical
- name (string) --
- address_line_1 (string) --
The address line 1 of the customer.
Max characters =50
- address_line_2 (string) --
The address line 2 of the customer.
Max characters =50
- city (string) --
The city associated to the customer.
Max characters =50
- state_province (string) --
The state/province associated to the customer.
Max characters =50
- zip_postal_code (string) --
The zip/postal code associated to the customer.
Max characters =20
- country (integer) --
The numeric code of the country.
To lookup a specific country numeric code, see the List Country API. - phone (string) --
The phone of the customer.
Max characters =20
- mobile (string) --
The mobile of the customer.
Max characters =20
- fax (string) --
The fax of the customer.
Max characters =20
- website (string) --
The website of the customer.
Max characters =50
- general_description (string) --
The general description of the customer.
Max characters =1000
- nda_signed (boolean) --
Whether the NDA has been signed by the customer.
Options:true
|false
- nda_signed_date (string) --
The NDA signed date by the customer.
Format =yyyy-MM-dd
- msa_signed (boolean) --
Whether the MSA has been signed by the customer.
Options:true
|false
- msa_signed_date (string) --
The MSA signed date by the customer.
Format =yyyy-MM-dd
- supplementary_description (string) --
The supplementary description of the customer.
Max characters =1000
- additional_description (string) --
The additional description of the customer.
Max characters =1000
- template (dict) --
- id (integer) --
The ID of the custom field template.
To lookup a specific custom field template ID, see the List Custom Field Template API. - fields (dict) --
- id (integer) --
The ID of the custom field.
To lookup a specific field ID, see the List Custom Field Template API. - value (decimal | integer | string) --
The value of the custom field.
- If the value data-type is
money
(decimal) --Min value =
0.00
Max value =999999999999999.00
- If the value data-type is
number
(integer) --Min value =
-999999999999999
Max value =999999999999999
- If the value data-type is
date
(string) --Format =
yyyy-MM-dd
- If the value data-type is
text
(string) --Max characters =
50
- If the value data-type is
- id (integer) --
- id (integer) --
Response Syntax
{
"id": integer,
"name": "string",
"category": {
"id": integer,
"name": "string"
},
"contact_person": {
"name": "string",
"email": "string",
"type": "account_management"|"billing"|"executive"|"sales"|"support"|"technical"
},
"address_line_1": "string",
"address_line_2": "string",
"city": "string",
"state_province": "string",
"zip_postal_code": "string",
"country": "string",
"phone": "string",
"mobile": "string",
"fax": "string",
"website": "string",
"general_description": "string",
"nda_signed": true|false,
"nda_signed_date": "string",
"msa_signed": true|false,
"msa_signed_date": "string",
"supplementary_description": "string",
"additional_description": "string",
"template":{
"id": integer,
"fields":{
key: value,...
}
}
}