Create Contact
const url = 'https://api.linqapp.com/api/partner/v2/contacts';const options = { method: 'POST', headers: { 'X-LINQ-INTEGRATION-TOKEN': '<X-LINQ-INTEGRATION-TOKEN>', 'Content-Type': 'application/json' }, body: '{"contact":{"first_name":"John","last_name":"Doe","email":"[email protected]","phone_number":"+15551234567","company":"Acme Corp","title":"CEO","location":"San Francisco, CA"}}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.linqapp.com/api/partner/v2/contacts \ --header 'Content-Type: application/json' \ --header 'X-LINQ-INTEGRATION-TOKEN: <X-LINQ-INTEGRATION-TOKEN>' \ --data '{ "contact": { "first_name": "John", "last_name": "Doe", "email": "[email protected]", "phone_number": "+15551234567", "company": "Acme Corp", "title": "CEO", "location": "San Francisco, CA" } }'Creates a new contact. You can optionally specify a user_email to assign the contact to a specific user in your organization. If not provided, the contact will be automatically associated with the first admin user.
Note: At least one of the following fields must be provided: first_name, last_name, email, or phone_number. Attempting to create a contact without any of these fields will result in a 422 validation error.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
object
Optional email of the user in your organization who should own this contact. Must be an existing user in your organization. If not provided, defaults to the first admin user.
Examples
Create contact with default owner
{ "contact": { "first_name": "John", "last_name": "Doe", "phone_number": "+15551234567", "company": "Acme Corp", "title": "CEO", "location": "San Francisco, CA" }}Create contact with specific owner
{ "contact": { "first_name": "John", "last_name": "Doe", "phone_number": "+15551234567", "company": "Acme Corp", "title": "CEO", "location": "San Francisco, CA" },}Responses
Section titled “ Responses ”Contact created successfully
object
object
The user who owns this contact in your organization
object
Example
{ "data": { "id": 123, "first_name": "John", "last_name": "Doe", "full_name": "John Doe", "phone_number": "+15551234567", "company": "Acme Corp", "title": "CEO", "location": "San Francisco, CA", "image_url": null, "created_at": "2025-07-30T10:00:00.000-05:00", "updated_at": "2025-07-30T10:00:00.000-05:00", "contact_owner": { "id": 456, "first_name": "Jane", "last_name": "Owner", "name": "Jane Owner" } }}Validation error or User not found
Alternative error format used by Contacts and Webhook Subscriptions endpoints (render_standard_error format)
object
Examples
Validation error
{ "status": "error", "error_code": "VALIDATION_ERROR", "message": "Contact validation failed", "errors": [ "At least one of the name, email, or phone number fields must be filled out for the contact" ]}User not found
{ "status": "error", "error_code": "USER_NOT_FOUND", "message": "Specified user not found", "errors": [ ]}