formdata.dev

get_form

Get form details including all destinations.

Parameters

Name Type Required Validation Description
formId string Yes -- Form ID (UUID)

Response Example

{
  "form": {
    "id": "a1b2c3d4-...",
    "organization_id": "org_abc123",
    "name": "Contact Form",
    "slug": "contact",
    "public_key": "pk_abc123...",
    "allowed_origins": ["https://acme.com"],
    "verify_captcha": 0,
    "captcha_secret": null,
    "is_enabled": 1,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z"
  },
  "destinations": [
    {
      "id": "d1e2f3a4-...",
      "form_id": "a1b2c3d4-...",
      "type": "smtp",
      "config": {
        "host": "smtp.example.com",
        "port": 587,
        "from": "[email protected]",
        "to": ["[email protected]"]
      },
      "is_enabled": 1,
      "created_at": "2025-01-15T10:35:00Z",
      "updated_at": "2025-01-15T10:35:00Z"
    }
  ]
}

Error Cases

Error Cause
Form not found. Invalid form ID or form belongs to a different organization
401 Unauthorized Invalid or expired secret key

Example Prompt

"Show me the details and destinations for my contact form."

TIP

CLI equivalent: npx formdata-dev forms get <formId>

ON THIS PAGE