openclaw-workspace/skills/api-gateway/references/cognito-forms.md

Cognito Forms Routing Reference

App name: cognito-forms Base URL proxied: www.cognitoforms.com

API Path Pattern

/cognito-forms/api/{endpoint}

Common Endpoints

Forms

List Forms

GET /cognito-forms/api/forms

Get Form

GET /cognito-forms/api/forms/{formId}

Entries

List Entries

GET /cognito-forms/api/forms/{formId}/entries

Get Entry

GET /cognito-forms/api/forms/{formId}/entries/{entryId}

Create Entry

POST /cognito-forms/api/forms/{formId}/entries
Content-Type: application/json

{
  "Name": {
    "First": "John",
    "Last": "Doe"
  },
  "Email": "john.doe@example.com"
}

Update Entry

PUT /cognito-forms/api/forms/{formId}/entries/{entryId}
Content-Type: application/json

{
  "Name": {
    "First": "Jane",
    "Last": "Doe"
  },
  "Email": "jane.doe@example.com"
}

Delete Entry

DELETE /cognito-forms/api/forms/{formId}/entries/{entryId}

Documents

Get Document

GET /cognito-forms/api/forms/{formId}/entries/{entryId}/documents/{templateNumber}

Files

Get File

GET /cognito-forms/api/files/{fileId}

Form Availability

Set Form Availability

PUT /cognito-forms/api/forms/{formId}/availability
Content-Type: application/json

{
  "start": "2026-03-01T00:00:00Z",
  "end": "2026-03-31T23:59:59Z",
  "message": "This form is currently unavailable."
}

Field Types

Complex fields use nested JSON objects:

• Name: {"First": "...", "Last": "..."}
• Address: {"Line1": "...", "Line2": "...", "City": "...", "State": "...", "PostalCode": "..."}
• Choice (single): "OptionValue"
• Choice (multiple): ["Option1", "Option2"]

Notes

• Form IDs can be internal form name (string) or numeric ID
• Entry IDs can be entry number (integer) or entry ID (GUID)
• Authentication is automatic - the router injects OAuth token
• Rate limit: 100 requests per 60 seconds
• File and document endpoints return temporary download URLs
• API scopes: Read, Read/Write, or Read/Write/Delete

Resources

• Cognito Forms API Overview
• REST API Reference
• API Reference