Skip to main content
POST
/
contacts
curl -X POST \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@example.com", "first_name": "Jane", "last_name": "Doe", "tags": ["speaker"]}' \
  "https://www.gomry.com/api/v1/contacts"

{
  "data": {
    "id": "AbCdEfGhIjKlMnOpQrSt",
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@example.com",
    "phone_number": null,
    "status": "active",
    "job_title": null,
    "company": null,
    "university": null,
    "gender": null,
    "birthday": null,
    "location": null,
    "linkedin": null,
    "instagram": null,
    "twitter": null,
    "github": null,
    "website": null,
    "tags": ["speaker"],
    "created_at": "2025-07-15T10:00:00.000Z",
    "updated_at": "2025-07-15T10:00:00.000Z"
  }
}

​
Create Contact

Creates a new contact in your organization. At least one of email or phone_number is required. If a contact with the same email already exists, the endpoint returns 409 Conflict with the existing contact data.

​
Request Body

​
email
string
Email address. Will be normalized to lowercase. Must be a valid email format.At least one of email or phone_number is required.
​
phone_number
string
Phone number in international format (e.g., +1234567890).At least one of email or phone_number is required.
​
first_name
string
First name.
​
last_name
string
Last name.
​
job_title
string
Job title.
​
company
string
Company name.
​
university
string
University name.
​
gender
string
Gender.
​
birthday
string
Birthday (any string format, e.g., 1990-01-15).
​
location
string
Location (e.g., New York, NY).
​
linkedin
string
LinkedIn URL.
​
instagram
string
Instagram handle or URL.
​
twitter
string
Twitter handle or URL.
​
github
string
GitHub handle or URL.
​
website
string
Website URL.
​
tags
string[]
Array of tags to assign to the contact.

​
Response

Returns the created contact object with a 201 Created status.
​
data
object
The created contact object (same schema as Get Contact).
curl -X POST \
  -H "X-API-KEY: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@example.com", "first_name": "Jane", "last_name": "Doe", "tags": ["speaker"]}' \
  "https://www.gomry.com/api/v1/contacts"

{
  "data": {
    "id": "AbCdEfGhIjKlMnOpQrSt",
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@example.com",
    "phone_number": null,
    "status": "active",
    "job_title": null,
    "company": null,
    "university": null,
    "gender": null,
    "birthday": null,
    "location": null,
    "linkedin": null,
    "instagram": null,
    "twitter": null,
    "github": null,
    "website": null,
    "tags": ["speaker"],
    "created_at": "2025-07-15T10:00:00.000Z",
    "updated_at": "2025-07-15T10:00:00.000Z"
  }
}