Sign Up
Loading...

Intercom commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Intercom, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands.

All connector references · Connect an account · AI setup and shared results

List contacts

Browse contacts in the authorized Intercom workspace.

Inputs

InputTypeHow to use it
AccountAccountRequired. Choose a saved Intercom connection from this workspace’s account selector. Create or reconnect it in Settings > Connectors first. Do not paste a password, API key or token into this field. Connect through the provider’s authorization screen. If setup is unavailable, ask your Twidget administrator to configure this connection.
CursortextOptional. Continuation value from pages.next.starting_after. Omit for the first page. Copy it unchanged and keep the same filters. Twidget text limit: 32,768 characters; provider-specific limits may be lower.
LimitnumberOptional. Maximum items requested in this page. Omit for 25; use a whole number from 1 to 100. The provider may return fewer items.

Result

Returns contacts in data and pages information. Put pages.next.starting_after into Cursor when present.

Example

Choose your Intercom Account and add List contacts. Set Limit = 10. Leave Cursor unset for the first page. These are illustrative values: replace example IDs and addresses with your own permitted test values. Inspect the returned result before continuing.

Errors and limits

Reconnect the authorized Intercom workspace and check contact permissions. Duplicate-contact rules can reject creation. Reconnect an unavailable connection in Settings > Connectors. Isolated tests and live debugging do not contact external services; Use live data is needed for an intended live call. If rate-limited, wait before retrying. Total input is limited to 64 KiB and results to 2 MiB; use smaller pages, narrower filters or less depth when too large. Calls wait up to 30 seconds, or less if the workflow reaches its own time limit. A timeout does not prove that a create/send failed, so check the provider before repeating it.

Get contact

Read an Intercom contact using its internal ID.

Inputs

InputTypeHow to use it
AccountAccountRequired. Choose a saved Intercom connection from this workspace’s account selector. Create or reconnect it in Settings > Connectors first. Do not paste a password, API key or token into this field. Connect through the provider’s authorization screen. If setup is unavailable, ask your Twidget administrator to configure this connection.
ContacttextRequired. Internal Intercom contact id from an earlier result, not an email address or external ID. Twidget text limit: 8,192 characters; provider-specific limits may be lower.

Result

Returns the contact object with id and available contact details.

Example

Choose your Intercom Account and add Get contact. Set Contact = "demo-contact-id". These are illustrative values: replace example IDs and addresses with your own permitted test values. Inspect the returned result before continuing.

Errors and limits

Reconnect the authorized Intercom workspace and check contact permissions. Duplicate-contact rules can reject creation. Reconnect an unavailable connection in Settings > Connectors. Isolated tests and live debugging do not contact external services; Use live data is needed for an intended live call. If rate-limited, wait before retrying. Total input is limited to 64 KiB and results to 2 MiB; use smaller pages, narrower filters or less depth when too large. Calls wait up to 30 seconds, or less if the workflow reaches its own time limit. A timeout does not prove that a create/send failed, so check the provider before repeating it.

Create contact

Create an Intercom contact with role user.

Inputs

InputTypeHow to use it
AccountAccountRequired. Choose a saved Intercom connection from this workspace’s account selector. Create or reconnect it in Settings > Connectors first. Do not paste a password, API key or token into this field. Connect through the provider’s authorization screen. If setup is unavailable, ask your Twidget administrator to configure this connection.
EmailtextRequired. Email for a new Intercom contact with role user. It does not search for or update an existing email match. Twidget text limit: 32,768 characters; provider-specific limits may be lower.
NametextOptional. Optional display name for the new user contact. Twidget text limit: 32,768 characters; provider-specific limits may be lower.

Result

Returns the created contact object and id. Existing contacts are not merged, and the role is not changed to lead.

Example

Choose your Intercom Account and add Create contact. Set Email = "alex@example.test". These are illustrative values: replace example IDs and addresses with your own permitted test values. An intended live run creates/changes data or sends a message; inspect its receipt before repeating it.

Errors and limits

Reconnect the authorized Intercom workspace and check contact permissions. Duplicate-contact rules can reject creation. Reconnect an unavailable connection in Settings > Connectors. Isolated tests and live debugging do not contact external services; Use live data is needed for an intended live call. If rate-limited, wait before retrying. Total input is limited to 64 KiB and results to 2 MiB; use smaller pages, narrower filters or less depth when too large. Calls wait up to 30 seconds, or less if the workflow reaches its own time limit. A timeout does not prove that a create/send failed, so check the provider before repeating it.

Test safely

Isolated tests and live debugging do not call connected providers. Enable Use live data only when you intend to contact the account. Writes, messages and AI requests can change real data or incur provider charges. A successful connection check does not prove access to every action. These examples explain the command contract; they are not evidence of a completed live provider request.

Related Topics

Airtable commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Airtable, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All...

OpenAI commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → OpenAI, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All c...

DeepSeek commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → DeepSeek, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All...

Anthropic (Claude) commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Anthropic (Claude), select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later comm...

Gmail commands

Use these commands from an endpoint, server function or event. Choose Add Command → Connector → Gmail, select the action, then choose an Account. Selecting an account reveals the remaining inputs. When the command returns a result, open OUTPUT and use Return as to name it for later commands. [All co...