Skip to main content
POST
/
v1
/
custom-fields
Create a custom field
curl --request POST \
  --url https://api-public.skipcall.app/v1/custom-fields \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Job Title"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Job Title",
  "slug": "job_title",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Enter your API Key (sk_live_xxx or sk_test_xxx)

Body

application/json
​
name
string
required

Name of the custom field

Required string length: 1 - 200
Example:

"Job Title"

Response

The created custom field

​
id
string
required
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
name
string
required

Human-readable label. Can be renamed without breaking integrations.

Example:

"Job Title"

​
slug
string
required

Stable, immutable identifier derived from the name at creation time. Use this as the key when setting custom field values on a contact via POST/PATCH /contacts.

Example:

"job_title"

​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required