{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can fetch the details of a single contact by external ID. Note that this endpoint only supports users and not leads.\n\n{% admonition type=\"info\" name=\"Merged contacts return 410 Gone\" %}\n  If the contact with this external ID has been merged into another contact, the API returns **HTTP 410 Gone** with a `Link` header pointing to the canonical (merged-into) contact. See `GET /contacts/{id}` for details on the response format.\n{% /admonition %}\n\nRequires the `read_single_user`, `read_users_companies` or `read_write_users` OAuth scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"external_id":{"type":"string","examples":["cdd29344-5e0c-4ef0-ac56-f9ba2979bc27"],"description":"The external ID of the user that you want to retrieve"}},"required":["external_id"],"additionalProperties":false},"query":{"type":"object","properties":{"include_merge_history":{"type":"boolean","default":false,"description":"Pass `true` to include the contact's merge history in the response. Returned for contacts of any role, with at most the 10 most recent merges."},"escape_identity":{"type":"boolean","default":true,"description":"By default, `name` and `email` values in the response, including nested ones such as social profile names, are HTML-escaped (for example, `&` is returned as `&amp;`). Custom attributes and tags are never escaped. Pass `false` to return them unescaped."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]}}},"name":"Get a contact by External ID","id":"intercom.showcontactbyexternalid","example":{"path":{"external_id":"cdd29344-5e0c-4ef0-ac56-f9ba2979bc27"}},"maxRequests":1,"summary":false}}