Create Contact

Creates a new contact under a user’s Contact List. Requires basic details such as first name, last name, email, and company name.

HTTP Method and URL

POST {{host}}/api/v2/network?user_type=ENTERPRISE_API

Authentication Requirements

Requires a valid user-token provided as an environment or global variable.

Query Parameters

• user_type (string, required): Must be set to ENTERPRISE_API.

Request Body

Content-Type: application/json

{
  "firstName": "string",   // Contact's first name
  "lastName": "string",    // Contact's last name
  "email": "string",       // Contact's email address
  "company": "string",     // Contact's company name
  "teams": "[1,2]"         // (Optional) Array of team IDs as a string
}

Example Request

POST {{host}}/api/v2/network?user_type=ENTERPRISE_API
Content-Type: application/json
Authorization: Bearer {USER-TOKEN}
{
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "company": "Acme Corp",
  "teams": "[1,2]"
}

Example Successful Response

{
  "id": "12345",
  "firstName": "John",
  "lastName": "Doe",
  "email": "[email protected]",
  "company": "Acme Corp",
  "teams": [1,2],
  "createdAt": "2024-06-01T12:00:00Z"
}

Error Responses

• 400 Bad Request: Missing or invalid fields in the request body.

• 401 Unauthorized: Invalid or missing authentication token.

• 409 Conflict: Contact already exists.

Usage Notes

• Ensure the user-token variable is set in your environment.

• The teams field is optional and should be a stringified array of team IDs.

• Only users with appropriate permissions can create contacts.