Create a counterpart (v2023-09-01) — Monite Documentation

Headers

Auth

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.

Organization

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

Individual

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

Response

Successful Response

Counterpart Individual Root Responseobject

Counterpart Organization Root Responseobject

Errors

1 curl -X POST https://api.sandbox.monite.com/v1/counterparts \ 2 -H "x-monite-version: 2023-09-01" \ 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": "individual", 8 "individual": { 9 "first_name": "Adnan", 10 "is_customer": true, 11 "is_vendor": true, 12 "last_name": "Singh", 13 "residential_address": { 14 "city": "Berlin", 15 "country": "AF", 16 "line1": "Flughafenstrasse 52", 17 "postal_code": "10115" 18 } 19 } 20 }'

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 "individual": { 10 "email": "asingh@example.net", 11 "first_name": "Adnan", 12 "is_customer": true, 13 "is_vendor": true, 14 "last_name": "Singh", 15 "phone": "5553211234", 16 "tags": [ 17 { 18 "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5", 19 "created_at": "2022-09-07T16:35:18Z", 20 "updated_at": "2022-09-07T16:35:18Z", 21 "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5", 22 "description": "Tag for the Marketing Department", 23 "name": "Marketing" 24 } 25 ], 26 "title": "Mr." 27 }, 28 "language": "ab", 29 "reminders_enabled": true, 30 "tax_id": "tax_id", 31 "type": "individual" 32 }

1	curl -X POST https://api.sandbox.monite.com/v1/counterparts \
2	-H "x-monite-version: 2023-09-01" \
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": "individual",
8	"individual": {
9	"first_name": "Adnan",
10	"is_customer": true,
11	"is_vendor": true,
12	"last_name": "Singh",
13	"residential_address": {
14	"city": "Berlin",
15	"country": "AF",
16	"line1": "Flughafenstrasse 52",
17	"postal_code": "10115"
18	}
19	}
20	}'

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	"individual": {
10	"email": "asingh@example.net",
11	"first_name": "Adnan",
12	"is_customer": true,
13	"is_vendor": true,
14	"last_name": "Singh",
15	"phone": "5553211234",
16	"tags": [
17	{
18	"id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
19	"created_at": "2022-09-07T16:35:18Z",
20	"updated_at": "2022-09-07T16:35:18Z",
21	"created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
22	"description": "Tag for the Marketing Department",
23	"name": "Marketing"
24	}
25	],
26	"title": "Mr."
27	},
28	"language": "ab",
29	"reminders_enabled": true,
30	"tax_id": "tax_id",
31	"type": "individual"
32	}