API REFERENCE

Records

Manage your contact data. Records are the individual entities (Leads, Patients, etc.) that your campaigns interact with. Each record is associated with a specific Record Type which defines its custom fields.

List all records

GEThttp://callcamp.ai/api/records

Returns a paginated list of records. You can filter by recordTypeUuid or campaignUuid, and search across custom fields.

Query Parameters

Parameter	Type	Description
recordTypeUuid	string	Filter by record type.
campaignUuid	string	Filter by assigned campaign.
search	string	Search across name, email, or phone number.
page	number	Page number for pagination.
limit	number	Items per page (max 100).

Responses

JSON

{
  "records": [
    {
      "uuid": "record_9z8y7x6w5v4u3t2s1r0q",
      "name": "John Doe",
      "firstName": "John",
      "lastName": "Doe",
      "email": "john.doe@example.com",
      "phoneNumber": "+1234567890",
      "country": "US",
      "status": "active",
      "parameters": {
        "amount": 50,
        "last_visit": "2026-04-01"
      },
      "createdAt": "2026-04-10T09:24:11Z",
      "updatedAt": "2026-04-22T13:58:02Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}

Create a new record

POSThttp://callcamp.ai/api/records

Creates a new record. You must specify the recordTypeUuid and provide the data for any required custom fields within the parameters object.

Body Parameters

Field	Type	Description
recordTypeUuid *	string	UUID of the record type defining the schema.
name	string	Display name (auto-generated if not provided).
firstName	string	Record first name.
lastName	string	Record last name.
phoneNumber *	string	Primary phone number in E.164 format.
email	string	Record email address.
country	string	ISO country code.
parameters	object	Key-value pairs for custom fields.

Responses

JSON

{
  "uuid": "record_9z8y7x6w5v4u3t2s1r0q",
  "name": "John Doe",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phoneNumber": "+1234567890",
  "country": "US",
  "status": "active",
  "parameters": {
    "amount": 50,
    "last_visit": "2026-04-01"
  },
  "createdAt": "2026-04-10T09:24:11Z",
  "updatedAt": "2026-04-22T13:58:02Z"
}

Get a record

GEThttp://callcamp.ai/api/records/{uuid}

Retrieves the full details of a specific record, including all its custom field values and associated campaign history.

Responses

JSON

{
  "uuid": "record_9z8y7x6w5v4u3t2s1r0q",
  "name": "John Doe",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phoneNumber": "+1234567890",
  "country": "US",
  "status": "active",
  "parameters": {
    "amount": 50,
    "last_visit": "2026-04-01"
  },
  "createdAt": "2026-04-10T09:24:11Z",
  "updatedAt": "2026-04-22T13:58:02Z"
}

Update a record

PATCHhttp://callcamp.ai/api/records/{uuid}

Updates an existing record. You can update the core fields or individual values within the parameters object.

Body Parameters

Field	Type	Description
name	string	Update display name.
firstName	string	Update first name.
lastName	string	Update last name.
phoneNumber	string	Update phone number.
email	string	Update email.
status	enum	Update record status.
parameters	object	Update custom field values.

Responses

JSON

{
  "uuid": "record_9z8y7x6w5v4u3t2s1r0q",
  "name": "John Doe",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "phoneNumber": "+1234567890",
  "country": "US",
  "status": "active",
  "parameters": {
    "amount": 50,
    "last_visit": "2026-04-01"
  },
  "createdAt": "2026-04-10T09:24:11Z",
  "updatedAt": "2026-04-22T13:58:02Z"
}

Delete a record

DELETEhttp://callcamp.ai/api/records/{uuid}

Permanently removes a record from your account. This action will also remove it from any assigned campaigns.

Responses

JSON

{
  "success": true,
  "message": "Record deleted successfully"
}