Competitor Tracker & Co. Docs

Competitor Tracker & Co. Docs

Start here

Getting started

Authentication

Using OAuth2 Using API keys Scopes and permissions

Guides

Competitors Track lists Agent signup Detected changes The weekly brief Labels Dispatches Slack Billing Organization Onboarding Onboarding checklist Feedback

MCP

API reference

Confirm an external brief subscription using the token from the confirmation email. Public — no authentication required. POST Unsubscribe an external recipient from a brief using the token from the brief email. Public — no authentication required. POST Record thumbs-up/down feedback on a change using the single-use token from a brief email. Public — no authentication required. POST List the current organization's notifications. GET Create a notification for the current organization. POST Rename, recolor, or rescope a notification belonging to the current organization. PATCH Delete a non-default notification belonging to the current organization. DELETE Add a recipient to a notification. Members are added immediately; external recipients are emailed a confirmation link and stay pending until they confirm. Admin-only. POST Remove a recipient from a notification. The pinned owner cannot be removed. Admin-only. DELETE List the current organization's webhooks. GET Register a webhook for the current organization. POST Delete a webhook, freeing one of the organization's slots. DELETE Show the Slack workspace connected to the current organization. GET Disconnect Slack from the current organization. DELETE List a webhook's delivery attempts, newest-first. GET List a notification's email delivery attempts, newest-first. GET List send and open events for a dispatch, newest-first. GET

Dispatches

Manage how the weekly brief is dispatched: email recipient lists (org members and external emails) and delivery webhooks, plus the per-channel delivery log.

Manage how the weekly brief is dispatched: email recipient lists (org members and external emails) and delivery webhooks, plus the per-channel delivery log. Every endpoint below has a "try it" console. See the API reference overview for the base URL and how to authenticate.

POST /v1/dispatches/recipients/confirm

Confirm an external brief subscription using the token from the confirmation email.

POST /v1/dispatches/recipients/remove

Unsubscribe an external recipient from a brief using the token from the brief email.

POST /v1/changes/{id}/feedback

Record thumbs-up/down feedback on a change using the single-use token from a brief email.

GET /v1/dispatches

List the current organization's notifications.

POST /v1/dispatches

Create a notification for the current organization.

PATCH /v1/dispatches/{id}

Rename, recolor, or rescope a notification belonging to the current organization.

DELETE /v1/dispatches/{id}

Delete a non-default notification belonging to the current organization.

POST /v1/dispatches/{id}/recipients

Add a recipient to a notification.

DELETE /v1/dispatches/{id}/recipients/{recipientId}

Remove a recipient from a notification.

GET /v1/dispatches/webhooks

List the current organization's webhooks.

POST /v1/dispatches/webhooks

Register a webhook for the current organization.

DELETE /v1/dispatches/webhooks/{id}

Delete a webhook, freeing one of the organization's slots.

GET /v1/dispatches/slack

Show the Slack workspace connected to the current organization.

DELETE /v1/dispatches/slack

Disconnect Slack from the current organization.

GET /v1/dispatches/webhooks/{id}/deliveries

List a webhook's delivery attempts, newest-first.

GET /v1/dispatches/{id}/deliveries

List a notification's email delivery attempts, newest-first.

GET /v1/dispatches/{id}/engagement

List send and open events for a dispatch, newest-first.

Unassign a label from a competitor (idempotent — succeeds even if not assigned). DELETE

Unassign a label from a competitor (idempotent — succeeds even if not assigned) — Competitor Tracker & Co. API reference for DELETE /v1/competitors/{id}/labels.

Confirm an external brief subscription using the token from the confirmation email. Public — no authentication required. POST

Confirm an external brief subscription using the token from the confirmation email. Public — no authentication required — Competitor Tracker & Co. API.