Create a contact | Solvimon

curl -X POST https://test.api.solvimon.com/v1/contacts \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "reference": "contact_202406",
  "customer_id": "cust_789456123",
  "email": "jane.doe@example.com"
}'

{
  "reference": "contact_202406",
  "customer_id": "cust_789456123",
  "email": "jane.doe@example.com",
  "object_type": "CONTACT",
  "id": "c123e456-789b-12d3-a456-426614174000",
  "name": {
    "first_name": "Jane",
    "last_name": "Doe",
    "infix": "van"
  },
  "notification_preferences": [
    {
      "type": "INVOICE",
      "channels": [
        {
          "type": "EMAIL",
          "enabled": true
        }
      ]
    }
  ],
  "custom_fields": [
    {
      "id": "cf_00123",
      "reference": "vip_status",
      "value": "gold",
      "values": [
        "gold",
        "silver",
        "bronze"
      ],
      "integration_details": {
        "payment_gateway_variant": "ADYEN",
        "id": "intg_45678",
        "reference": "payment_gateway_1",
        "adyen": {
          "recurring_detail_reference": "recurring_987654321"
        },
        "stripe": {
          "payment_method_id": "pm_1GqIC8Lz0qyl6XeW3Xq1"
        }
      }
    }
  ],
  "linked_integrations": [
    {
      "id": "intg_link_001",
      "link_details": [
        {
          "url": "https://integration.example.com/details/123",
          "custom_field_name": "integration_code"
        }
      ]
    }
  ]
}

Requires the CONTACT.CREATE permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

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

Path parameters

versionstringRequiredDefaults to 1

version

Request

This endpoint expects an object.

referencestringRequiredformat: "^\S+$"0-256 characters

A custom reference assigned to the contact.

customer_idstringRequired

The ID of the customer.

emailstringRequiredformat: "(\S*@\S*\..*)"0-256 characters

The email of the contact.

nameobject or nullOptional

A custom name assigned to the contact.

notification_preferenceslist of objects or nullOptional

Notification preferences for contact-related communications.

custom_fieldslist of objects or nullOptional

linked_integrationslist of objects or nullOptional

Response

Created

referencestringformat: "^\S+$"0-256 characters

A custom reference assigned to the contact.

customer_idstring

The ID of the customer.

emailstringformat: "(\S*@\S*\..*)"0-256 characters

The email of the contact.

object_typestring or nullRead-only

idstring or nullRead-only

nameobject or null

A custom name assigned to the contact.

notification_preferenceslist of objects or null

Notification preferences for contact-related communications.

custom_fieldslist of objects or null

linked_integrationslist of objects or null

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors