Create a counterpart | Monite Documentation

1 curl -X POST https://api.sandbox.monite.com/v1/counterparts \ 2 -H "x-monite-version: 2024-05-25" \ 3 -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \ 4 -H "Authorization: Bearer <token>" \ 5 -H "Content-Type: application/json" \ 6 -d '{ 7 "type": "organization", 8 "organization": { 9 "address": { 10 "city": "Berlin", 11 "country": "AF", 12 "line1": "Flughafenstrasse 52", 13 "postal_code": "10115" 14 }, 15 "is_customer": true, 16 "is_vendor": true, 17 "legal_name": "Acme Inc." 18 } 19 }'

1 { 2 "id": "id", 3 "created_at": "2024-01-15T09:30:00Z", 4 "updated_at": "2024-01-15T09:30:00Z", 5 "created_automatically": true, 6 "default_billing_address_id": "default_billing_address_id", 7 "default_shipping_address_id": "default_shipping_address_id", 8 "created_by_entity_user_id": "created_by_entity_user_id", 9 "external_reference": "123456789", 10 "individual": { 11 "email": "asingh@example.net", 12 "first_name": "Adnan", 13 "is_customer": true, 14 "is_vendor": true, 15 "last_name": "Singh", 16 "phone": "5553211234", 17 "tags": [ 18 { 19 "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5", 20 "created_at": "2022-09-07T16:35:18Z", 21 "updated_at": "2022-09-07T16:35:18Z", 22 "category": "document_type", 23 "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5", 24 "description": "Tag for the Marketing Department", 25 "name": "Marketing" 26 } 27 ], 28 "title": "Mr." 29 }, 30 "language": "ab", 31 "reminders_enabled": true, 32 "tax_id": "tax_id", 33 "type": "individual" 34 }

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.

organizationobjectRequired

This schema is used to create counterparts that are organizations (juridical persons).

individualobjectRequired

This schema is used to create counterparts that are individuals (natural persons).

Response

Successful Response

Counterpart Individual Root Responseobject

Counterpart Organization Root Responseobject

Headers

Request

Response

Errors