POST / Create Contact – Leadfwd

POST /v2/contact/create

POST /v2/contact/create/{listId}

Header

HTTP/1.1
Authorization: Bearer $api_id.$api_secret
Host: api.$app_domain
Accept: application/json
Content-Type: application/json

Request Parameters

listId (required)	Leadfwd List ID to assign your new contact. (integer)
name (required)	Full name including first and last name (string)
email (required)	Valid email format: john@domain.com (string)
segment_id	Add your new contact to an existing list segment. (integer)
tags	Attach tags to your new contact. Add multiple comma separated values: tag1, tag2. (string)
sequence_id	Enroll your new contact to a Sequence. (integer)
hubspot_id	Relate to a HubSpot contact record ID. (integer)
pipedrive_id	Relate to a Pipedrive contact record ID. (integer)

You can find the numerical {listId} value from the URL in the Contact Manager after logging into your account or using this API endpoint GET All Contact Lists

Custom Data Field Properties

Append data values for custom data field properties in any array by requesting the field names and then include them in your array.

The example request below with "company", which is a custom data field property. You can request a full list of your available custom data field properties using GET /v2/field/all/

Request

POST /v2/contact/create/{listId} 
HTTP/1.1 Authorization: Bearer {$key}.{$secret}
Host: {api.app.domain} 
Accept: application/json 
Content-Type: application/json 

{ 
    "name": ”John Doe”,
    "email": ”john.doe@domain.com”, 
    "company": "string", 
    "segment_id": "integer", 
    "sequence_id": "integer", 
    "tags": "tag1,tag2",
    "hubspot_id": "integer",
    "pipedrive_id": "integer",
}

Response

HTTP/1.1 201 Created
{
    "id": "0",
    "message": "Success!"
}

Error code

HTTP/1.1 404 Not Found
{
    "id": "0",
    "message": "Error description"
}