Update a contact | Solvimon

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

{
  "reference": "CNT-20240601-001",
  "customer_id": "CUST-789456123",
  "email": "jane.doe@example.com",
  "object_type": "contact",
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef56gh78",
  "name": {
    "first_name": "Jane",
    "last_name": "Doe",
    "infix": "van"
  },
  "notification_preferences": [
    {
      "type": "INVOICE",
      "channels": [
        {
          "type": "EMAIL",
          "enabled": true
        }
      ]
    }
  ],
  "custom_fields": [
    {
      "id": "cf-00123",
      "reference": "LOYALTY_LEVEL",
      "value": "Gold",
      "values": [
        "Gold",
        "Silver",
        "Bronze"
      ],
      "integration_details": {
        "payment_gateway_variant": "ADYEN",
        "id": "int-45678",
        "reference": "PAYMENT_GATEWAY_01",
        "adyen": {
          "recurring_detail_reference": "recurring-ref-987654321"
        },
        "stripe": {
          "payment_method_id": "pm_1GqIC8Lz0qyl6XeW3xYz1234"
        }
      }
    }
  ],
  "linked_integrations": [
    {
      "id": "link-7890",
      "link_details": [
        {
          "url": "https://crm.example.com/integrations/link-7890",
          "custom_field_name": "CRM_Contact_ID"
        }
      ]
    }
  ]
}

Requires the CONTACT.UPDATE 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

resourceIdstringRequiredDefaults to

The ID of the resource to be requested.

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

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

500

Internal Server Error

Authentication

Path parameters

Headers

Request

Response

Errors