Skip to main content
POST
/
contact-properties
curl --request POST \
  --url https://api.autosend.com/v1/contact-properties \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "company",
    "type": "string"
  }'

{
  "success": true,
  "message": "Contact property created successfully",
  "data": {
    "id": "6960953e729f65f154369408",
    "name": "company",
    "type": "string",
    "fieldName": "company",
    "fieldType": "string",
    "createdAt": "2026-01-09T05:42:22.171Z",
    "updatedAt": "2026-01-09T05:42:22.171Z"
  }
}

curl --request POST \
  --url https://api.autosend.com/v1/contact-properties \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "company",
    "type": "string"
  }'

{
  "success": true,
  "message": "Contact property created successfully",
  "data": {
    "id": "6960953e729f65f154369408",
    "name": "company",
    "type": "string",
    "fieldName": "company",
    "fieldType": "string",
    "createdAt": "2026-01-09T05:42:22.171Z",
    "updatedAt": "2026-01-09T05:42:22.171Z"
  }
}

​
Authorizations

​
Authorizations
string | header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
Body Parameters

​
name
string
required
The programmatic name for the contact property. Must be unique within the project. Cannot be one of the reserved names: firstName, first_name, lastName, last_name, email, mobile, unsubscribed, unsubscribe, unsubscribe_groups, unsubscribe_preferences, userId, externalId, createdAt, updatedAt, contactLists, address, address_line_1, address_line_2, city, state, zip, country.The legacy fieldName parameter is still accepted as an alias for name.
​
type
string
required
The data type of the contact property. Must be one of: string, number, boolean, date.The legacy fieldType parameter is still accepted as an alias for type.
​
description
string
A human-readable description of what the property represents.
​
defaultValue
string
A fallback value used when a contact does not have an explicit value for this property.

​
Response

Contact property created successfully
​
success
boolean
Indicates whether the request was successful.
​
message
string
Confirmation message.Example: "Contact property created successfully"
​
data
object
The created contact property.