curl --request POST \
--url https://api.rootfi.dev/v4/accounting/contacts \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"company_id": 123,
"data": [
{
"name": "fguvkhg",
"contact_name": null,
"contact_type": "CUSTOMER",
"currency_id": "00000000-0000-0000-0000-000000000000",
"tax_number": null,
"registration_number": null,
"status": null,
"email": "abc@gmail.com",
"website": "www.abc.com",
"telephone": "1234567890",
"mobile": "1234567890",
"fax": "1234567890",
"addresses": [
{
"rootfi_id": 278264,
"platform_id": "CONTACTS_1af68894-ea9f-ee11-be36-7c1e520f50bc_ADDRESS",
"street": "123 Main Street",
"locality": "Main Street",
"city": "New York",
"state": "New York",
"pincode": "123456",
"country": "USA"
}
]
}
]
}
'{
"data": {
"rootfi_id": 238858,
"rootfi_deleted_at": null,
"rootfi_created_at": "2024-01-24T11:11:59.779Z",
"rootfi_updated_at": "2024-01-24T11:11:59.000Z",
"rootfi_company_id": 1109,
"platform_id": "123456_1",
"platform_unique_id": "123456",
"name": "Acme Corporation",
"contact_name": "John Doe",
"contact_type": "customer",
"currency_id": "00000000-0000-0000-0000-000000000000",
"tax_number": "ODSPS1279G",
"registration_number": "07CEUPK5322M1ZX",
"status": "active",
"updated_at": "2024-01-24T11:11:59.000Z",
"external_links": [],
"phone_numbers": [
{
"rootfi_id": 278264,
"platform_id": "CONTACTS_1af68894-ea9f-ee11-be36-7c1e520f50bc_PHONE",
"number": "1234567890",
"type": "MOBILE"
}
],
"addresses": [
{
"rootfi_id": 278264,
"platform_id": "CONTACTS_1af68894-ea9f-ee11-be36-7c1e520f50bc_ADDRESS",
"street": "123 Main Street",
"locality": "Main Street",
"city": "New York",
"state": "New York",
"pincode": "123456",
"country": "USA"
}
]
}
}Create a contact.
curl --request POST \
--url https://api.rootfi.dev/v4/accounting/contacts \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"company_id": 123,
"data": [
{
"name": "fguvkhg",
"contact_name": null,
"contact_type": "CUSTOMER",
"currency_id": "00000000-0000-0000-0000-000000000000",
"tax_number": null,
"registration_number": null,
"status": null,
"email": "abc@gmail.com",
"website": "www.abc.com",
"telephone": "1234567890",
"mobile": "1234567890",
"fax": "1234567890",
"addresses": [
{
"rootfi_id": 278264,
"platform_id": "CONTACTS_1af68894-ea9f-ee11-be36-7c1e520f50bc_ADDRESS",
"street": "123 Main Street",
"locality": "Main Street",
"city": "New York",
"state": "New York",
"pincode": "123456",
"country": "USA"
}
]
}
]
}
'{
"data": {
"rootfi_id": 238858,
"rootfi_deleted_at": null,
"rootfi_created_at": "2024-01-24T11:11:59.779Z",
"rootfi_updated_at": "2024-01-24T11:11:59.000Z",
"rootfi_company_id": 1109,
"platform_id": "123456_1",
"platform_unique_id": "123456",
"name": "Acme Corporation",
"contact_name": "John Doe",
"contact_type": "customer",
"currency_id": "00000000-0000-0000-0000-000000000000",
"tax_number": "ODSPS1279G",
"registration_number": "07CEUPK5322M1ZX",
"status": "active",
"updated_at": "2024-01-24T11:11:59.000Z",
"external_links": [],
"phone_numbers": [
{
"rootfi_id": 278264,
"platform_id": "CONTACTS_1af68894-ea9f-ee11-be36-7c1e520f50bc_PHONE",
"number": "1234567890",
"type": "MOBILE"
}
],
"addresses": [
{
"rootfi_id": 278264,
"platform_id": "CONTACTS_1af68894-ea9f-ee11-be36-7c1e520f50bc_ADDRESS",
"street": "123 Main Street",
"locality": "Main Street",
"city": "New York",
"state": "New York",
"pincode": "123456",
"country": "USA"
}
]
}
}| Integration | Field | Description | Required |
|---|---|---|---|
| MS_DYNAMICS_365_FO | CustomerGroupId | The customer group ID to which the contact belongs. This should be passed if the contact_type is CUSTOMER. | Yes |
| MS_DYNAMICS_365_FO | VendorGroupId | The vendor group ID to which the contact belongs. This should be passed if the contact_type is VENDOR. | Yes |
| MYOB_BUSINESS | tax_code | The tax code to which the contact belongs. | Yes |
| SAGE_ZA_CLOUD_ACCOUNTING | code | The code of the contact. | Yes |