Set a mailbox signature
Fixed text with the variables {{first_name}}, {{last_name}}, {{title}} and {{company}}, filled from this mailbox. Plain text, or simple HTML with format: "html" (links, line breaks, bold, italic). replies_only (default true) keeps it out of campaign emails: write {{signature}} in a campaign email and it renders only when this is false. Replies always carry it, and agent replies sign with it. Only the fields you send change.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Writes | argorant:manage_lists |
Authorization
BearerAuth Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.
In: header
Path Parameters
The mailbox address.
emailHeader Parameters
Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.
length <= 128Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.
^[A-Za-z0-9._-]{8,64}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PUT "https://app.argorant.com/api/v1/inboxes/elena@northgate-advisory.com/signature" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "template": "Best,\\n{{first_name}} {{last_name}}\\n{{title}}, {{company}}", "title": "Head of Growth", "company": "Northgate Advisory" }'{ "email": "elena@northgate-advisory.com", "own": { "template": "Best,\n{{first_name}} {{last_name}}\n{{title}}, {{company}}", "format": "text", "replies_only": true }, "effective": { "source": "inbox", "replies_only": true, "text": "Best,\nElena Vaughn\nHead of Growth, Northgate Advisory" }}