Enable Forge
enable-forgeMove a domain's sending to Forge and get the Forge CNAME plus any pending Receiving MX record to add at your DNS provider before verification.
Instructions
Enable Forge for a domain in Resend. Forge is Resend's own sending infrastructure, and enabling it starts moving the domain's sending onto Forge with a dedicated return path. Forge offers better deliverability and faster sending. Returns the domain with a new Forge CNAME record among its DNS records. For a domain that receives email, enabling also moves receiving, and the response includes a pending Receiving MX record with a new value. The whole flow is: 1. call this tool, 2. display the returned Forge CNAME record, and the pending Receiving MX record when there is one, to the user so they can update their DNS provider, 3. once the user has updated DNS, call verify-domain with scope ["forge"], 4. poll get-domain until the Forge CNAME record's status is "verified", matching it by name and value, and until the Receiving MX record is "verified" too when it moved. Do not rely on the top-level domain status for this: it can show "verified" before the MX record moves. Always pass scope ["forge"] when verifying Forge: it checks only the Forge record, so the records that are already verified are not re-proven. Enabling does not start verification, and the domain keeps sending through its current records while the Forge record verifies, so there is no interruption. Idempotent: calling it again for a domain already on Forge returns the current state without starting a new migration.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "enable-forge"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Domain ID | |
| customReturnPath | No | Subdomain for the Forge Return-Path address. Must start with a letter, end with a letter or digit, contain only letters, digits, and hyphens, and be 2 to 63 characters long. When omitted, Resend picks a label that is free in your DNS. Set once when Forge is enabled and cannot be changed afterwards. |