Get Contact by ID - AutoSend Documentation

GET

contacts

{id}

curl --request GET \
  --url https://api.autosend.com/v1/contacts/{id} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe",
    "userId": "user_12345",
    "customFields": {
      "company": "Acme Corp",
      "role": "Developer",
      "plan": "premium"
    },
    "listIds":["692822107f092ea9019d3af8"],
    "segmentIds":["6a0c0fb56ae88a19f5a010a9"],
    "updatedAt": "2024-01-15T10:30:00.000Z",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "projectId": "229f1f77bcf86cd9273048038"
  }
}

curl --request GET \
  --url https://api.autosend.com/v1/contacts/{id} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe",
    "userId": "user_12345",
    "customFields": {
      "company": "Acme Corp",
      "role": "Developer",
      "plan": "premium"
    },
    "listIds":["692822107f092ea9019d3af8"],
    "segmentIds":["6a0c0fb56ae88a19f5a010a9"],
    "updatedAt": "2024-01-15T10:30:00.000Z",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "projectId": "229f1f77bcf86cd9273048038"
  }
}

Authorizations

string | header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Unique contact IDExample: "507f1f77bcf86cd799439011"

Response

Contact retrieved successfully

success

boolean

Indicates if the request was successfulExample: true

data

object

Show child attributes

data.id

string

Contact IDExample: "507f1f77bcf86cd799439011"

data.email

string

Contact email addressExample: "[email protected]"

data.firstName

string

Contact’s first nameExample: "John"

data.lastName

string

Contact’s last nameExample: "Doe"

data.userId

string

Your application’s user identifierExample: "user_12345"

data.customFields

object

Custom contact attributes

Show child attributes

customFields.{key}

string

Example:

{
  "company": "Acme Corp",
  "role": "Developer",
  "plan": "premium"
}

data.createdAt

string

Contact creation timestampExample: "2024-01-15T10:30:00.000Z"

data.updatedAt

string

Contact last update timestampExample: "2024-01-15T10:30:00.000Z"

data.projectId

string

Project ID that the contact belongs toExample: "229f1f77bcf86cd9273048038"

data.listIds

array

Contact List IDsExample: ["692822107f092ea9019d3af8"]

data.segmentIds

array

Segment IDs the contact belongs toExample: ["6a0c0fb56ae88a19f5a010a9"]

Remove Contacts

Search Contacts by Emails

curl --request GET \
  --url https://api.autosend.com/v1/contacts/{id} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe",
    "userId": "user_12345",
    "customFields": {
      "company": "Acme Corp",
      "role": "Developer",
      "plan": "premium"
    },
    "listIds":["692822107f092ea9019d3af8"],
    "segmentIds":["6a0c0fb56ae88a19f5a010a9"],
    "updatedAt": "2024-01-15T10:30:00.000Z",
    "createdAt": "2024-01-15T10:30:00.000Z",
    "projectId": "229f1f77bcf86cd9273048038"
  }
}

​Authorizations

​Path Parameters

​Response

Authorizations

Path Parameters

Response