API reference

Customer Properties API

Read and update custom profile fields on marketing customers from your backend or website.

Authentication

Include your marketing API key in the X-API-Key header on every request.

Create an API key in Marketing → API keys. Send it on every request.

Base URL: https://marketing.rcvtechnologies.com

Required headers

X-API-Key: YOUR_API_KEY
Accept: application/json
Content-Type: application/json

Customer identification

Pass exactly one customer identifier per request (query string or JSON body).

Parameter	Type	Example
`customer_id`	integer	`42`
`customer_uuid`	uuid	`9b2f3c1a-4e5d-6f7a-8b9c-0d1e2f3a4b5c`
`visitor_id`	string	`vis_abc123`
`user_id`	string	`usr_789`
`email`	email	`[email protected]`

Endpoints

GET /api/customers/properties

List properties

Return all profile properties for the identified customer.

Query parameters

{
    "customer_uuid": "{{uuid}}"
}

Example response

{
    "status": "ok",
    "customer_id": 42,
    "customer_uuid": "9b2f3c1a-4e5d-6f7a-8b9c-0d1e2f3a4b5c",
    "properties": [
        {
            "key": "company_name",
            "value": "Acme Inc",
            "type": "text",
            "updated_at": "2026-06-01T12:00:00+00:00"
        }
    ]
}

cURL

curl -X GET \
  'https://marketing.rcvtechnologies.com/api/customers/properties' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Accept: application/json'

PUT /api/customers/properties

Bulk update

Update up to 50 property keys in one request.

Request body

{
    "customer_uuid": "{{uuid}}",
    "properties": {
        "company_name": "Acme Inc",
        "plan_tier": "enterprise"
    }
}

Example response

{
    "status": "updated",
    "customer_id": 42,
    "customer_uuid": "9b2f3c1a-4e5d-6f7a-8b9c-0d1e2f3a4b5c",
    "properties": []
}

cURL

curl -X PUT \
  'https://marketing.rcvtechnologies.com/api/customers/properties' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"customer_uuid":"{{uuid}}","properties":{"company_name":"Acme Inc","plan_tier":"enterprise"}}'

PATCH /api/customers/properties/{propertyKey}

Update one property

Set a single property. Optional type: text, number, date, boolean, url.

Request body

{
    "customer_uuid": "{{uuid}}",
    "value": "Acme Inc",
    "type": "text"
}

Example response

{
    "status": "updated",
    "customer_id": 42,
    "property": {
        "key": "company_name",
        "value": "Acme Inc",
        "type": "text"
    }
}

cURL

curl -X PATCH \
  'https://marketing.rcvtechnologies.com/api/customers/properties/{propertyKey}' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"customer_uuid":"{{uuid}}","value":"Acme Inc","type":"text"}'

DELETE /api/customers/properties/{propertyKey}

Delete property

Remove a property key from the customer profile.

Query parameters

{
    "customer_uuid": "{{uuid}}"
}

Example response

{
    "status": "deleted",
    "customer_id": 42,
    "key": "company_name"
}

cURL

curl -X DELETE \
  'https://marketing.rcvtechnologies.com/api/customers/properties/{propertyKey}' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Accept: application/json'

Authentication

Customer identification

Endpoints

List properties

Bulk update

Update one property

Delete property

Get product updates and marketing insights