Errors

Errors have a JSON body with an error field:

{ "error": "event not found" }

Status codes

Status	Meaning	What to do
`400`	The request is not valid. For example, the event ID is not a number, or a Free project has no destination.	Fix the request.
`401`	No API key, a wrong key, or a wrong source signature.	Check the key or the signature.
`402`	No credits, an unpaid plan, or a source over the plan limit.	Add credits or change the plan.
`403`	The workspace is suspended, or the key’s creator has no verified email.	Contact the workspace owner.
`404`	Not found, or not in this workspace.	Check the IDs.
`409`	Nothing to do. For example, a retry on an event with no `dead` delivery.	No action needed.
`410`	`POST /proxy/:userID` is removed.	Send events to `POST /p/<source-id>`.
`423`	The source is paused.	Resume the source.
`429`	Too many requests.	Wait. For ingest, wait for `Retry-After`.
`5xx`	A problem on our side.	Retry with backoff. For ingest, wait for `Retry-After`.

Destination refusals

Saving a destination, or delivering to one, returns 400 when the URL is not allowed. The error field names the cause and the fix. It does not include a resolved IP address.

Cause	What to do
Port other than `80`, `443`, or `1024` to `65535`	Use `443`, `80`, or a port from `1024` to `65535`.
Service port on a private, internal, metadata, or Hooksnode address	Use a public URL. A public address may use any allowed port, including `3000` and `5432`.
Private or internal address	Use a public hostname that resolves to a public IP.
Hooksnode’s own network	Use your own public URL.
DNS did not resolve	Check the hostname for a typo and try again.

A delivery that fails for another reason stores a short error on the attempt: DNS, timeout, connection, TLS, or an HTTP status outside 200 to 299. Each one says how to fix it. Open the event in the portal to read it. Changing a watched URL or an IMAP server without sending the secret again returns 400. Enter the header values or the password for the new address and save.

Rate limits

What	Limit
Ingest, for each source	1,000 a minute by default. Up to 1,000,000 on Pro.
REST API, for each key	600 a minute
Retries and replays, for each user	60 a minute

Overview

Ingest

Projects

Events

Streaming

Status codes

Destination refusals

Rate limits

​Status codes

​Destination refusals

​Rate limits

Status codes

Destination refusals

Rate limits