Create a counterpart | Monite Documentation

curl -X POST https://api.sandbox.monite.com/v1/counterparts \
     -H "x-monite-version: 2024-05-25" \
     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "type": "organization",
  "organization": {
    "address": {
      "city": "Berlin",
      "country": "AF",
      "line1": "Flughafenstrasse 52",
      "postal_code": "10115"
    },
    "is_customer": true,
    "is_vendor": true,
    "legal_name": "Acme Inc."
  }
}'

{
  "id": "id",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "created_automatically": true,
  "created_by_entity_user_id": "created_by_entity_user_id",
  "default_billing_address_id": "default_billing_address_id",
  "default_shipping_address_id": "default_shipping_address_id",
  "external_reference": "123456789",
  "individual": {
    "email": "asingh@example.net",
    "first_name": "Adnan",
    "is_customer": true,
    "is_vendor": true,
    "last_name": "Singh",
    "phone": "5553211234",
    "tags": [
      {
        "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
        "created_at": "2022-09-07T16:35:18Z",
        "updated_at": "2022-09-07T16:35:18Z",
        "category": "document_type",
        "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
        "description": "Tag for the Marketing Department",
        "name": "Marketing"
      }
    ],
    "title": "Mr."
  },
  "language": "ab",
  "reminders_enabled": true,
  "tax_id": "tax_id",
  "type": "individual"
}

Authentication

AuthorizationBearer

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

Headers

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

object

Errors

401

Post Counterparts Request Unauthorized Error

403

Post Counterparts Request Forbidden Error

422

Post Counterparts Request Unprocessable Entity Error

429

Post Counterparts Request Too Many Requests Error