Create or Update Contact

Create new contact

post

Create a new or update contact in the system. To update existing contact, provide the user_id or the same email & firstname, or phone & firstname. In addition to the attributes listed below, you can add any custom attributes to the contact.

Header parameters

X-API-KEYstringrequired

Your API key

X-SECRET-KEYstringrequired

Your Secret key

Body

app_idstringrequired

first_namestringrequired

last_namestringrequired

emailstring · emailoptional

phonestringoptional

addressstringoptional

citystringoptional

statestringoptional

zipstringoptional

sourcestringoptional

user_idstringoptional

dobdateoptional

YYYY-MM-DD

created_datedatetimeoptional

YYYY-MM-DD HH:MM:SS

genderstringoptional

typestringoptional

eg. member, past, prospect

statusstringoptional

eg. active, inactive, non-member etc

locationstringoptional

optin_smsbooleanoptional

optout_emailbooleanoptional

tagsstringoptional

comma separated tags

tag_actionstringoptional

add or remove

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.gleantap.com/v2/ExternalApi/newContact' \
  --header 'X-API-KEY: text' \
  --header 'X-SECRET-KEY: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "app_id": "text",
    "first_name": "text",
    "last_name": "text",
    "email": "[email protected]",
    "phone": "text",
    "address": "text",
    "city": "text",
    "state": "text",
    "zip": "text",
    "source": "text",
    "user_id": "text",
    "dob": null,
    "created_date": null,
    "gender": "text",
    "type": "text",
    "status": "text",
    "location": "text",
    "optin_sms": true,
    "optout_email": true,
    "tags": "text",
    "tag_action": "text"
  }'

200

400

200

{
  "status": "success",
  "_id": "text"
}

Contact created successfully