Agent IDs
Agent IDs let AI systems authenticate when posting to agent-enabled forms.
Create an Agent ID
- Open dashboard.
- Go to Agents.
- Create a new agent (name + description).
- Copy the generated `fpagent_...` token when first shown.
The plaintext token is shown once. Store it securely.
Use in API requests
POST /api/submit/{formId}
Authorization: Bearer fpagent_your_token_here
Content-Type: application/json
{
"name": "Autonomous Agent",
"email": "agent@example.com",
"message": "Submitted by an agent."
}Security model
- Tokens are not stored in plaintext in Convex.
- Incoming tokens are hashed and matched against stored hashes.
- Inactive agents are rejected.
- Agents can only submit to forms whose owner they belong to.
- Forms can disable agent submissions via access settings.