Get forms-relay config for a site
get_forms_configRead the form-to-email relay config of a site, plus the resolved delivery mode, the active From address, and (for a custom sender domain) the DNS records to publish and their verification status. Submissions: POST JSON to the returned endpoint with Content-Type: application/json (UTF-8). Flat object of form fields (strings/numbers/booleans; checkbox groups may be arrays of strings, joined with ', '). Max 30 fields, 5000 chars/field, 20000 total. Response: {success:true,data:{ok:true}} or {success:false,error:{code,message}}. Rate limit: 10 submits per IP per 10 minutes. Include a hidden honeypot input (default "_gotcha") and leave it empty.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siteName | Yes | The site whose forms-relay config to read. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | ||
| enabled | Yes | ||
| delivery | Yes | platform | verified-domain | verified-domain-pending | custom-relay. | |
| endpoint | Yes | URL the site's form should POST to. | |
| siteName | Yes | ||
| request_id | No | Server-assigned request correlation id. Quote it when contacting support. | |
| formsConfig | Yes | Stored config (smtpRelay.password redacted to hasPassword). | |
| activeSender | Yes | The From that will actually be used right now. | |
| senderDomain | No | DNS records to publish + verification status (verified-domain path). |