Create Conversation: Intercom action

Inputs

The fields this action accepts.

Every field can be mapped from an upstream trigger, AI step, table row, or hard-coded literal.

Field	Type	Required	Description
From Type from_type	options	Required	Who is initiating the conversation
Contact ID from_id	string	Required	The Intercom ID of the contact starting the conversation
Message Body body	string	Required	Initial message content (supports HTML)

Sample request

{
  "from_type": "{{trigger.from_type}}",
  "from_id": "e.g. 5f7b1a2...",
  "body": "e.g. Hi, I need help with..."
}

Returns

{
  "id": "123456789",
  "type": "conversation",
  "source": {
    "body": "Hi, I need help with...",
    "type": "conversation"
  },
  "contacts": {
    "contacts": [
      {
        "id": "5f7b1a2",
        "type": "contact"
      }
    ]
  },
  "created_at": 1700000000
}

Use these fields in downstream nodes for routing, logging, or error handling.

FAQ

Questions about Create Conversation.

What does the Create Conversation action do in Intercom?

Creates a new conversation on behalf of a contact, kicking off the thread from their side. Useful when piping inbound messages from another channel (email, social) into Intercom.

What inputs does Create Conversation require?

Required: From Type, Contact ID, Message Body. Every input accepts a static value or a variable from any upstream node in your workflow.

Can I use dynamic inputs from earlier workflow nodes?

Yes. Any field on this action can pull values from upstream nodes, whether that's a form response, a trigger payload, an AI output, or a lookup result.

What happens if Intercom returns an error?

The workflow pauses on the failed node, the error message is captured in the run log, and you can retry the run with one click. Auto-retry policies are configurable per workflow with exponential backoff up to 5 attempts.

Does Create Conversation support batch operations?

Yes. Run Create Conversation inside a Loop node to process arrays. Tiny Command handles Intercom's rate limits automatically so you don't have to throttle manually.

More actions