Enable Forge
Put a domain’s sending on Resend Forge.
POST
This endpoint returns the DNS record Forge needs. Add it to your DNS and call
Verify Domain with
scope: ["forge"],
then poll Retrieve Domain until the
Forge record’s status is verified.
Calling this endpoint again just returns the current state.
The domain keeps sending through its current records while the Forge record
verifies, so there is no interruption.
The domain must be a sending domain. Receive-only domains, domains on a
dedicated IP, and domains with legacy DKIM get a
forge_unavailable error.Path Parameters
Body Parameters
Headers
Add an idempotency key to enable Forge only once.
- Should be unique per API request
- Idempotency keys expire after 24 hours
- Have a maximum length of 256 characters
- A retry with the same key returns the first successful response, with the
idempotent-replayed: trueheader - A failed request is not stored, so you can retry it with the same key
- Reusing the key with a different body, or while the first request is still
running, returns a
409