Docs

Troubleshooting

Custom sites

"The site refused Sei's signature" (401 or 403)

The secret on your server isn't the one Sei has. Copy the secret again (or Rotate secret and copy the new one), set it in your environment, and redeploy. On Vercel a changed environment variable needs a new deployment. Check that nothing rewrites the body before the handler reads it: the signature covers the raw bytes, so a JSON body parser in front of the route breaks it (Express: mount seiExpress before express.json()).

"Timestamp too old" (401 timestamp-too-old)

Your server's clock is more than 5 minutes off. Sync it (NTP).

Check connection says the site can't be reached

The URL must be the endpoint itself over https://, and its final address: Sei never follows a redirect, so a 301 from http to https or from www to the bare domain fails. Sei waits 20 seconds for ping.

"503 not-configured"

SEI_WEBHOOK_SECRET isn't set where the handler runs.

A feature I added doesn't show in Sei

Sei shows what ping last said. Click Check connection after deploying a new handler.

"Body too large" (413)

@getsei/webhook reads up to 5 MB. Raise maxBodyBytes if your articles are bigger.

A publish times out but the article appears on the site

Sei waits 40 seconds. Its next attempt sends the same seiId without an externalId: find the article by seiId and update it instead of creating a second one.

Conflicts on every publish

Your revision must change on every save and only then: send the same value back that you stored. A timestamp with one-second resolution can miss an edit made in the same second; use milliseconds, a counter or a hash.

WordPress

WordPress doesn't show "Authorize application"

Application passwords need HTTPS (or WP_ENVIRONMENT_TYPE=local), and some security plugins switch them off.

Connected, but SEO title and meta description don't arrive

Install and activate the GetSei plugin, then Check connection.

Publishing fails with "forbidden"

The approved user needs to publish posts, and creating a category needs manage_categories. Without upload_files the post still publishes, without the cover as its featured image.

Requests are blocked by a firewall

A challenge page (Cloudflare, Sucuri, a host's bot protection) answers instead of WordPress. Allow requests to /wp-json/ from Sei, or allowlist its User-Agent.