canonical: https://jentic.com/apis/bluetick.io/bluetick # Bluetick.io API Jentic publishes the only available OpenAPI specification for Bluetick.io API, keeping it validated and agent-ready. Bluetick.io is an automated email follow-up tool that moves leads through a sales funnel by triggering personalised follow-up emails until a prospect replies. The API exposes accounts, contacts, and sequences, letting integrators add contacts to a sequence, manage contact records, and read per-sequence metrics on send volume and reply rates. Authentication uses an API key issued from the Bluetick dashboard. ## For AI agents Add leads to automated email follow-up sequences in Bluetick.io and read engagement metrics without using the dashboard. ## Scope Does not author email content, send transactional or marketing broadcasts, or score leads - use for managing contacts and enrolling them in pre-built Bluetick follow-up sequences only. ## Capabilities - Add a new contact to a Bluetick account by email and metadata - Enrol an existing contact in a follow-up sequence - Update a contact's profile fields including their primary email address - Remove a contact from the system to stop further follow-ups - List the sequences configured under an account - Read per-sequence metrics on contact-level progress and action-level send/reply counts - Look up a contact by email address or contact ID ## Use cases ### CRM-triggered follow-up enrolment Enrol new leads in a Bluetick follow-up sequence automatically when they enter the CRM. POST /v1/accounts/{accountId}/contacts creates the contact, then POST /v1/accounts/{accountId}/sequences/{id}/contacts adds them to the chosen sequence. Bluetick handles the staged email sends and stops as soon as the lead replies. Suitable for SDR pipelines, founder-led outbound, and event lead follow-up. Example prompt: Call POST /v1/accounts/{accountId}/contacts with the lead's email and name, then POST /v1/accounts/{accountId}/sequences/{id}/contacts to enrol them in the sequence. ### Sequence performance reporting Pull per-sequence metrics for sales reporting dashboards. GET /v1/accounts/{accountId}/sequences/{id}/metrics/contacts returns contact-level progress (where each lead is in the sequence), and GET .../metrics/actions returns action-level send and reply counts. Useful for measuring step-by-step drop-off and identifying high-performing follow-up templates. Example prompt: Call GET /v1/accounts/{accountId}/sequences/{id}/metrics/actions and return the send count and reply count for each step. ### Contact list hygiene Keep the Bluetick contact list clean by updating primary email addresses when leads change jobs, removing stale records, and re-keying contacts that bounced. PUT /v1/accounts/{accountId}/contacts/{emailAddressOrContactId} updates a contact, PUT .../emailaddresses/primary swaps which email is primary, and DELETE removes the contact entirely. Example prompt: Call PUT /v1/accounts/{accountId}/contacts/{contactId}/emailaddresses/primary with the new email to swap which address Bluetick uses for follow-ups. ### Reply detection and re-routing When Bluetick stops a sequence because a lead replied, follow up downstream by reading the sequence's contact-level metrics and routing replies into the CRM as a hot lead. The action-level metrics endpoint surfaces reply counts, and the contact-level endpoint shows which contacts are in 'replied' state versus still being followed up. Example prompt: Pull GET /v1/accounts/{accountId}/sequences/{id}/metrics/contacts and identify contacts whose state indicates they have replied. ### AI agent SDR copilot Let an AI agent enrol leads, surface sequence performance, and clean the contact list on behalf of a sales rep. The agent searches Jentic for the right Bluetick operation by intent, loads the schema, and executes with the API key held in your Jentic One instance. Suitable for Slack-based SDR copilots and outbound campaign automations driven by an LLM. Example prompt: Search Jentic for 'add a contact to a Bluetick sequence', load the schema, and execute it with the lead's email and the target sequence ID. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | /v1/accounts/{accountId}/contacts | Create a new contact | | POST | /v1/accounts/{accountId}/sequences/{id}/contacts | Enrol a contact in a sequence | | GET | /v1/accounts/{accountId}/contacts/{emailAddressOrContactId} | Look up a contact by email or ID | | PUT | /v1/accounts/{accountId}/contacts/{emailAddressOrContactId} | Update a contact's profile fields | | DELETE | /v1/accounts/{accountId}/contacts/{emailAddressOrContactId} | Remove a contact from Bluetick | | GET | /v1/accounts/{accountId}/sequences | List sequences in the account | | GET | /v1/accounts/{accountId}/sequences/{id}/metrics/actions | Read per-step send and reply metrics | ## Key resources - **Accounts** — Top-level Bluetick account resource for namespacing contacts and sequences - **Contacts** — Lead records with email addresses, profile fields, and primary email management - **Sequences** — Configured follow-up sequences with step-level metrics on sends and replies ## Why Jentic - **Setup:** Wiring Bluetick by hand means implementing its API key auth and threading the account id and contact identifiers through each call yourself. Through Jentic you install once, import Bluetick from the API Directory, store the API key once, and your agent calls it. - **Permission scoping:** Bluetick puts the account, sequence, and contact ids in the URL path (/v1/accounts/{accountId}/contacts/{emailAddressOrContactId}), so a rule can pin your agent to one account: it can add contacts and enroll them in sequences and nothing else. You choose the operations it may call, so deleting a contact is not included unless you add it. - **Credential handling:** Your Bluetick API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'add a contact to a Bluetick sequence' or 'pull sequence metrics', and Jentic returns the matching Bluetick operation with its input schema so the agent calls the right endpoint without browsing the docs. ## Related APIs - **Blueshift** — Multi-channel customer engagement platform - broader scope than Bluetick's email-only follow-up - **Bloomerang** — Donor CRM - pair when nonprofit prospect outreach should run through Bluetick sequences - **BlueInk** — E-signature - pair to send a contract once a Bluetick sequence triggers a positive reply ## FAQ ### Why is there no official OpenAPI spec for Bluetick.io API? Bluetick.io publishes a developer documentation page but does not distribute a maintained OpenAPI 3 file. Jentic generates and maintains this spec so AI agents and developers can call Bluetick via standard tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Bluetick.io API use? Bluetick.io uses an API key issued from the Bluetick dashboard, passed as an Authorization header. Through Jentic, the API key is stored in the encrypted vault and injected at execution, so the agent never handles the raw key. ### Can I add a contact to a sequence through this API? Yes. First create the contact with POST /v1/accounts/{accountId}/contacts (or look up an existing contact via GET .../contacts/{emailAddressOrContactId}), then enrol them with POST /v1/accounts/{accountId}/sequences/{id}/contacts. Bluetick will start the configured follow-up cadence on the next scheduled send. ### What are the rate limits for the Bluetick.io API? Bluetick applies per-account rate limits not enumerated in the spec. Practical guidance is to keep request volume modest (under roughly 60 requests per minute per key); HTTP 429 responses include backoff hints. Higher limits are available on request for enterprise plans. ### How do I read sequence performance metrics through Jentic? Search Jentic for 'pull Bluetick sequence metrics', load the schema for GET /v1/accounts/{accountId}/sequences/{id}/metrics/actions, and execute it with the accountId and sequence id. Install with pip install jentic and call await client.execute(ExecutionRequest(...)). ### Does Bluetick stop sending when a lead replies? Yes. Reply detection is a core Bluetick feature - once a contact replies to any message in the sequence, subsequent steps are skipped and their state is recorded in the contact-level metrics. The action and contact metrics endpoints expose this state for downstream automation. ### Is the Bluetick.io API free? Bluetick.io operates on a paid subscription model. API access is included with paid plans, with limits scaling by tier. A trial is typically available; check the Bluetick.io pricing page for current details. ### Can I limit what my agent is allowed to do with the Bluetick.io API? Yes. Jentic One runs self-hosted, so your own rules decide which Bluetick operations and credentials the agent may use. Because Bluetick puts the account, sequence, and contact IDs in the URL path, you can pin the agent to a single account and let it only create contacts and enroll them in sequences with POST /v1/accounts/{accountId}/contacts and POST /v1/accounts/{accountId}/sequences/{id}/contacts. Destructive calls such as DELETE on a contact stay out of scope unless you explicitly add them to the agent's allowed operations.