Skip to main content

Setup

Install the Intercom integration from the Courier integrations catalog. You will need your Intercom access token and an admin/bot user ID to send messages from.

Profile Requirements

To deliver an in-app push message to a recipient over Intercom, you must provide the recipient’s Intercom User ID. Courier assumes the user is of type user.
{
  "message": {
    "to": {
      "intercom": {
        "from": "012345",
        "to": {
          "id": "INTERCOM_USER_ID"
        }
      }
    }
  }
}

Overrides

You can use the provider override to replace what Courier sends as an Intercom Message. Supported overrides include the message body and the From User ID. Here’s an example where both are overridden:
{
  "message": {
    "template": "NOTIFICATION_TEMPLATE_ID",
    "to": {
      "intercom": {
        "id": "INTERCOM_USER_ID"
      }
    },
    "providers": {
      "intercom": {
        "override": {
          "body": {
            "body": "I overrode this message",
            "from": {
              "id": "012345"
            }
          }
        }
      }
    }
  }
}
Other supported overrides are documented in the Intercom API reference.