Drip

Manage subscribers, tags, and e-commerce email automation workflows via the Drip REST API.

Drip is an e-commerce marketing automation platform (ECRM). This tool wraps the core contact + tag endpoints so you can read and manage your audience from any InTouch job, schedule, or the AI assistant.

What it does

Calls the real Drip v2 API (https://api.getdrip.com/v2/<account_id>/...) using HTTP Basic authentication — your API token is the username and the password is empty. No external Python packages: standard library only (urllib, json, base64). Response bodies are capped at 5 MB. The raw JSON response and HTTP status are returned so a downstream step (or the assistant) can interpret them; non-2xx responses are surfaced rather than thrown, so you can inspect Drip's error document.

Operations

Inputs

• apiKey (required) — Drip API token.
• accountId (required) — your numeric Drip account id.
• operation (required) — one of the operations above.
• contact — id or email for get-contact (falls back to email).
• email — contact email for upsert-contact / apply-tag.
• tag — tag name for apply-tag (optional on upsert-contact).
• customFields — JSON object string of custom fields for upsert-contact, e.g. {"shirt_size":"Medium"}.
• page / perPage — pagination for list-subscribers (defaults 1 / 100).

Outputs

• result — the raw JSON response body from Drip (as a string).
• status — the HTTP status code (as a string).

API key setup

1. Log in to Drip.
2. Go to Settings → User Settings → API Token.
3. Copy your API Token — this is the apiKey.
4. Your account id is the numeric id shown in your Drip dashboard URL (e.g. https://www.getdrip.com/<account_id>/...) — this is accountId.

Authentication is HTTP Basic with the token as the username and an empty password (Authorization: Basic base64("<apiKey>:")).

Examples

List the first page of subscribers:

operation = list-subscribers
apiKey    = <your token>
accountId = 9999999
perPage   = 50

Fetch one contact by email:

operation  = get-contact
apiKey     = <your token>
accountId  = 9999999
email      = [email protected]

Create or update a contact with a tag and a custom field:

operation    = upsert-contact
apiKey       = <your token>
accountId    = 9999999
email        = [email protected]
tag          = Customer
customFields = {"shirt_size":"Medium"}

Apply a tag to a contact:

operation = apply-tag
apiKey    = <your token>
accountId = 9999999
email     = [email protected]
tag       = SEO

List all tags in the account:

operation = list-tags
apiKey    = <your token>
accountId = 9999999

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

• error
• result
• status

Input Properties

Every property this tool accepts, from its own tool.iml.