IthuraDocs
Open app

Zapier / Make

Exposes Ithura as an integration platform: it fires triggers when things happen in Ithura and accepts actions to create or update Ithura data from other apps. Direction: bidirectional. Unlike the other integrations, it uses a workspace API token instead of OAuth.

What it does

Triggers (Ithura to your automation):

  • Instant triggers fan out to a subscriber's target_url the moment an event happens: issue.created, issue.updated, issue.state_changed, issue.assigned, comment.created, cycle.started, cycle.completed, module.completed.
  • Polling triggers are also available for new issues, updated issues, and new comments.

Actions (your automation to Ithura):

  • Create an issue, add a comment, update an issue's state, and find an issue.
  • Schema lookups (projects, states, labels, members) power dropdowns in Zapier and Make.

Verifying payloads

Each subscription gets a per-subscription HMAC key, and every delivery carries an X-Ithura-Signature: sha256=... header plus an X-Ithura-Event header. Verify these in your Zap or scenario if you want to authenticate Ithura's payloads.

Connect (workspace admin)

There is no OAuth step. Authentication uses a workspace API token:

  1. Workspace settings -> Integrations -> Zapier / Make card.

  2. Create a workspace API token. The card links to /{workspace}/settings/api-tokens. This token authenticates every connector request.

  3. In Zapier or Make, point the Ithura app at the base URL shown on the card:

    https://<api-host>/v1/connector/<workspace-slug>/

    Authenticate with the workspace API token.

Configure per project

Subscriptions can be scoped to the whole workspace or narrowed to a single project. The card lists active subscriptions (with a disable control) and recent deliveries (with a retry control).

Using it

  • Build Zaps or scenarios on the triggers and actions above.
  • Deliveries are logged and retried with backoff. A subscription that fails 10 times in a row is automatically disabled, so a dead endpoint does not retry forever. Re-enable it from the card after fixing the endpoint.

Troubleshooting

  • 401 on every call: the workspace API token is missing, wrong, or revoked. Rotate it in Workspace settings -> API tokens and update Zapier or Make.
  • Signature verification failing: verify against X-Ithura-Signature using the per-subscription HMAC key.
  • Subscription stopped firing: it may have auto-disabled after repeated failures. Check recent deliveries and re-enable it.