Actions

Call the createConnectorRule MCP tool

Save a NEW automation rule on a connected integration. The rule is always saved OFF: nothing runs until activateConnectorRule (launch scope) or Settings turns it on. direction "outbound" reacts to a Reachium event (trigger.event from the webhook catalog, e.g. lead.accepted) and runs one of the provider's own actions (action.type such as add_lead_to_campaign, with params like { provider_campaign_id }); direction "inbound" reacts to a provider event (trigger.event provider.*) and runs a Reachium action: add_to_campaign { campaign_id }, add_tag / remove_tag { tag }, set_lead_status { status }, mark_booked {}, record_booking {}, or send_linkedin_message { template } which, once activated, DMs the matched lead automatically. Events and action names are validated against the specific provider, so an unsupported pairing is refused with the reason. Each action type accepts exactly its own params (see the schema); unknown keys are refused. Pull getPlaybook("integrations", "connectors") first for the recipes and template variables.

Called through the Actions bridge: the response is that tool's own result, wrapped as { data: <tool result> } under HTTP 200. Billing, daily-cap, and confirm-step outcomes are embedded INSIDE data, never remapped to an HTTP status (see the templated /api/v1/actions/{toolName} operation above for the full protocol, and x-mcp-actions for this tool's machine-readable scope/cap/confirm_behavior fields). Authentication, request-shape, and optional idempotency-protocol failures still use their documented non-200 statuses.

post/api/v1/actions/createConnectorRule

Request

  • Base URL: https://app.reachium.io
  • URL: https://app.reachium.io/api/v1/actions/createConnectorRule
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional caller-generated key (8-200 characters: letters, digits, dot, underscore, colon, or hyphen). A final tool result is replayed for the same key and body. An ambiguous result remains 409 under that key; reconcile external state before using a new key. Reuse with a different body returns 422.

Request body

integration_idstring uuid required

From getConnectors.

direction'outbound' | 'inbound' required

"outbound": a Reachium event calls the provider. "inbound": a provider event acts inside Reachium.

daily_capinteger

Per-rule daily run cap. Defaults to 25 for send_linkedin_message (max 50), 100 otherwise.

Response

The result of calling this tool.

dataunknown required
errorunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.