PATCH
/
api
/
teams
/
{teamId}
/
contacts
/
{contactId}
curl --request PATCH \
  --url https://firstquadrant.ai/api/teams/{teamId}/contacts/{contactId} \
  --header 'Bearer API key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Anand Chowdhary",
  "nickname": "Anand",
  "bio": "Founder, CTO, CPO of FirstQuadrant. GitHub Star, Forbes 30 Under 30, Y Combinator.",
  "avatar": "https://firstquadrant.ai/avatar.jpg",
  "website": "https://firstquadrant.ai",
  "location": "San Francisco, CA, USA",
  "timeZone": "America/Los_Angeles",
  "city": "San Francisco",
  "state": "California",
  "countryCode": "US",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "employmentTitle": "Chief Technology Officer",
  "employmentSeniority": "c_suite"
}'
{
  "id": "con_qxwVhUwAj3ijxWXstmCNvIII",
  "createdAt": "2024-05-12T00:00:00.000Z",
  "updatedAt": "2024-05-12T00:00:00.000Z",
  "blockedAt": "2024-05-12T00:00:00.000Z",
  "name": "Anand Chowdhary",
  "nickname": "Anand",
  "bio": "Founder, CTO, CPO of FirstQuadrant. GitHub Star, Forbes 30 Under 30, Y Combinator.",
  "avatar": "https://firstquadrant.ai/avatar.jpg",
  "website": "https://firstquadrant.ai",
  "location": "San Francisco, CA, USA",
  "timeZone": "America/Los_Angeles",
  "city": "San Francisco",
  "state": "California",
  "countryCode": "US",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "employmentTitle": "Chief Technology Officer",
  "employmentSeniority": "c_suite",
  "companyId": "com_qxwVhUwAj3ijxWXstmCNvIII",
  "rootContactId": "rcn_qxwVhUwAj3ijxWXstmCNvIII"
}

Authorizations

Bearer API key
string
headerrequired

The API key used to authenticate requests, learn how to generate an API key on the Authentication page.

Path Parameters

teamId
string
required

Team ID, starting with tea_

contactId
string
required

Contact ID, starting with con_

Body

application/json
name
string

The full name of the contact.

nickname
string

The nickname of the contact, e.g., the first name.

bio
string

The bio of the contact.

avatar
string

The URL of the avatar of the contact.

website
string

The URL of the personal website of the contact.

location
string

The residential location of the contact.

timeZone
string

The time zone of the contact in the IANA time zone database format.

city
string

The city of the contact's residential location.

state
string

The state of the contact's residential location.

countryCode
string

The country code of the contact's residential location in the ISO 3166-1 alpha-2 format.

latitude
number

The latitude of the contact's residential location.

longitude
number

The longitude of the contact's residential location.

employmentTitle
string

The current job title of the contact.

employmentSeniority
enum<string>

The seniority level of the contact in their current job.

Available options:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp

Response

200 - application/json
id
string

The unique ID of the contact, starting with con_.

createdAt
string

The date and time the contact was created.

updatedAt
string

The date and time the contact was last updated.

blockedAt
string

The date and time the contact was unsubscribed.

name
string

The full name of the contact.

nickname
string

The nickname of the contact, e.g., the first name.

bio
string

The bio of the contact.

avatar
string

The URL of the avatar of the contact.

website
string

The URL of the personal website of the contact.

location
string

The residential location of the contact.

timeZone
string

The time zone of the contact in the IANA time zone database format.

city
string

The city of the contact's residential location.

state
string

The state of the contact's residential location.

countryCode
string

The country code of the contact's residential location in the ISO 3166-1 alpha-2 format.

latitude
number

The latitude of the contact's residential location.

longitude
number

The longitude of the contact's residential location.

employmentTitle
string

The current job title of the contact.

employmentSeniority
enum<string>

The seniority level of the contact in their current job.

Available options:
c_suite,
director,
entry,
founder,
head,
intern,
manager,
owner,
partner,
senior,
vp
companyId
string

The unique ID of the company the contact works at, starting with com_.

rootContactId
string

The globally unique ID of the root contact, starting with rcn_.