Create an agent profile

POST

/agents

mode is off / summarize / draft (auto opens after guardrail validation).

Authorization

bearerAuth

headerAuthorizationBearer <token>

Mailly API key（Authorization: Bearer ）

application/json

name?string

Name, up to 100 characters

persona_prompt?string

Persona prompt, up to 8000 characters

mode?string

off / summarize / draft

address_id?|

Inbox address ID to bind; null leaves it unbound

allowed_senders?array<string>

Sender allowlist, up to 100 entries

skills?array<>

User-defined skills; an empty array deletes all skills

Itemsitems <= 20

summary_prompt?|

Summary prompt for evaluations, up to 4000 characters; null, blank, or a built-in default follows the workspace language

[key: string]?unknown

Created

application/json

success*boolean

id*string

[key: string]?unknown

curl -X POST 'https://api.mailly.site/agents' \  -H 'Content-Type: application/json' \  -d '{  "property1": null,  "property2": null}'

{  "success": true,  "id": "string",  "property1": null,  "property2": null}