DocsBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Convert a Visitor to a Lead

Example Lead Convert Request

$ curl \
https://api.intercom.io/visitors/convert \
-X POST \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json' \
-H 'Content-Type: application/json' -d '
{
  "visitor": {
    "user_id": "8a88a590-e1c3-41e2-a502-e0649dbf721c"
  },
  "type": "lead"
}'
HTTP/1.1 200 Ok

{
  "type": "user",
  "email": "[email protected]"
}
# NB: Full User objects are returned

Visitors can be converted to Leads. This is done by passing Visitor identifiers and a type attribute set to 'lead'.