Skip to content

Team, plans and limits

A workspace has owners and members. This page covers invites and roles, then the delivery behavior and plan limits that apply to every hook.

Team and invites

A workspace has owners and members. Owners invite people by email from the Settings page, and pick the role the invitee gets.

  • An invite link works once and expires after 7 days. Revoking a pending invite stops its link at once.
  • The invitee opens /invite/<token>, signed in with the invited address. That address must be verified. Accepting with any other account is refused.
  • If no invite email can be sent, the owner sees the link once, on the Settings page, and passes it on.
  • Owners invite, revoke invites, change roles, remove members, change alert settings and delete secrets. Members can read alert settings and set secrets.
  • Anyone can leave a workspace, except the last owner. A workspace always keeps at least one owner, so promote another owner before the last one leaves, is removed or is demoted.

Behavior and limits

  • The sender gets 200 as soon as the event is stored. Deliveries are queued and sent in the background, so a slow destination never makes the sender time out.
  • Network errors, timeouts, 5xx, 408, 425 and 429 are retried on a schedule from 30 seconds to 24 hours (or the retry policy in the YAML), honouring Retry-After. Other 4xx and redirects fail at once.
  • When the schedule is used up the delivery is marked failed and the event failed or partial. Retry the delivery or replay the event once the cause is fixed.
  • Requests that repeat a provider delivery id (webhook-id, x-github-delivery, x-shopify-webhook-id, ...) within 24 hours are accepted once.
  • Destinations must be public HTTPS URLs; private, loopback and metadata addresses are refused.
  • Events keep their payload, deliveries and attempt logs unless logging.retainPayload is false. They are kept for 7 days on Free and 30 days on Pro, or less if a hook sets logging.retainDays.
  • Each workspace can create 5 hooks on Free and 25 on Pro. Creating one past the limit is refused; updating an existing hook always works.
  • Events are metered monthly: 10,000 on Free and 100,000 on Pro. Past the allowance, events keep flowing and the usage page shows the overage.
  • Hosted agent generations are metered monthly: 50 on Free and 1,000 on Pro. Up to 10 generations a minute per workspace. Instructions are limited to 4,000 characters and the sample payload to 64 KB.
  • Upgrading and cancelling are on the Usage page. Stripe runs checkout and the billing portal, which holds invoices and the payment method.
  • Incoming bodies are limited to 1 MB.
  • There is no ordering guarantee between events.