Create a contact

curl --request POST \
  --url https://api.reply.io/v3/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "id": 12345,
  "email": "john.doe@company.com",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "title": "Senior Product Manager",
  "company": "Tech Solutions Inc",
  "domain": "company.com",
  "city": "San Francisco",
  "state": "CA",
  "country": "United States",
  "timeZoneId": "America/Los_Angeles",
  "phone": "+1-415-555-0123",
  "phoneStatus": "verified",
  "linkedInProfile": "https://www.linkedin.com/in/johndoe",
  "linkedInSalesNavigator": "https://www.linkedin.com/sales/profile/123456",
  "linkedInRecruiter": "https://www.linkedin.com/recruiter/profile/789012",
  "companySize": "501-1000",
  "industry": "Software & Technology",
  "notes": "Met at SaaS Conference 2024",
  "addingDate": "2024-03-08T10:00:00Z",
  "customFields": [
    {
      "key": "leadSource",
      "value": "Conference"
    },
    {
      "key": "budget",
      "value": "100k-250k"
    }
  ]
}'

{
  "id": 12345,
  "email": "john.doe@company.com",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "title": "Senior Product Manager",
  "company": "Tech Solutions Inc",
  "domain": "company.com",
  "city": "San Francisco",
  "state": "CA",
  "country": "United States",
  "timeZoneId": "America/Los_Angeles",
  "phone": "+1-415-555-0123",
  "phoneStatus": "verified",
  "linkedInProfile": "https://www.linkedin.com/in/johndoe",
  "linkedInSalesNavigator": "https://www.linkedin.com/sales/profile/123456",
  "linkedInRecruiter": "https://www.linkedin.com/recruiter/profile/789012",
  "companySize": "501-1000",
  "industry": "Software & Technology",
  "notes": "Met at SaaS Conference 2024",
  "addingDate": "2024-03-08T10:00:00Z",
  "customFields": [
    {
      "key": "leadSource",
      "value": "Conference"
    },
    {
      "key": "budget",
      "value": "100k-250k"
    }
  ]
}

POST

contacts

Create a contact

curl --request POST \
  --url https://api.reply.io/v3/contacts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "id": 12345,
  "email": "john.doe@company.com",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "title": "Senior Product Manager",
  "company": "Tech Solutions Inc",
  "domain": "company.com",
  "city": "San Francisco",
  "state": "CA",
  "country": "United States",
  "timeZoneId": "America/Los_Angeles",
  "phone": "+1-415-555-0123",
  "phoneStatus": "verified",
  "linkedInProfile": "https://www.linkedin.com/in/johndoe",
  "linkedInSalesNavigator": "https://www.linkedin.com/sales/profile/123456",
  "linkedInRecruiter": "https://www.linkedin.com/recruiter/profile/789012",
  "companySize": "501-1000",
  "industry": "Software & Technology",
  "notes": "Met at SaaS Conference 2024",
  "addingDate": "2024-03-08T10:00:00Z",
  "customFields": [
    {
      "key": "leadSource",
      "value": "Conference"
    },
    {
      "key": "budget",
      "value": "100k-250k"
    }
  ]
}'

{
  "id": 12345,
  "email": "john.doe@company.com",
  "firstName": "John",
  "lastName": "Doe",
  "fullName": "John Doe",
  "title": "Senior Product Manager",
  "company": "Tech Solutions Inc",
  "domain": "company.com",
  "city": "San Francisco",
  "state": "CA",
  "country": "United States",
  "timeZoneId": "America/Los_Angeles",
  "phone": "+1-415-555-0123",
  "phoneStatus": "verified",
  "linkedInProfile": "https://www.linkedin.com/in/johndoe",
  "linkedInSalesNavigator": "https://www.linkedin.com/sales/profile/123456",
  "linkedInRecruiter": "https://www.linkedin.com/recruiter/profile/789012",
  "companySize": "501-1000",
  "industry": "Software & Technology",
  "notes": "Met at SaaS Conference 2024",
  "addingDate": "2024-03-08T10:00:00Z",
  "customFields": [
    {
      "key": "leadSource",
      "value": "Conference"
    },
    {
      "key": "budget",
      "value": "100k-250k"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

API key passed in the X-API-Key header

Body

application/json

string<email>

required

Primary email address

integer

Unique ID

firstName

string

First name

lastName

string

Last name

phone

string

Phone number

title

string

Job title

company

string

Organization name

companySize

string

Organization employee count

industry

string

Business sector

linkedInProfile

string<uri>

LinkedIn profile URL

linkedInSalesNavigator

string<uri>

Sales Navigator URL

linkedInRecruiter

string<uri>

Recruiter URL

city

string

City of residence

state

string

State/province

country

string

Country

timeZoneId

string

Timezone identifier

phoneStatus

string

Phone validation status

notes

string

Additional information

customFields

object[]

User-defined fields

Show child attributes

Response

201 - application/json

Contact created successfully

string<email>

required

Primary email address

integer

Unique ID

firstName

string

First name

lastName

string

Last name

phone

string

Phone number

title

string

Job title

company

string

Organization name

companySize

string

Organization employee count

industry

string

Business sector

linkedInProfile

string<uri>

LinkedIn profile URL

linkedInSalesNavigator

string<uri>

Sales Navigator URL

linkedInRecruiter

string<uri>

Recruiter URL

city

string

City of residence

state

string

State/province

country

string

Country

timeZoneId

string

Timezone identifier

domain

string

Email domain

phoneStatus

string

Phone validation status

notes

string

Additional information

addingDate

string<date-time>

Creation timestamp

customFields

object[]

User-defined fields

Show child attributes

List all contacts Get a contact

Introduction

API Documentation

Schemas

Create a contact

Authorizations

Body

Response