curl -X POST https://api.gork.email/v1/inboxes \
-H "Authorization: Bearer gork_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "sales-rep",
"name": "Sales Representative"
}'
{
"data": {
"id": "inb_89a0b12",
"address": "sales-rep@gork.email",
"name": "Sales Representative",
"isActive": true,
"createdAt": "2026-09-07T00:00:00.000Z"
}
}
Inboxes
Create Inbox
Provision a new dedicated email address for an AI agent.
POST
/
v1
/
inboxes
curl -X POST https://api.gork.email/v1/inboxes \
-H "Authorization: Bearer gork_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "sales-rep",
"name": "Sales Representative"
}'
{
"data": {
"id": "inb_89a0b12",
"address": "sales-rep@gork.email",
"name": "Sales Representative",
"isActive": true,
"createdAt": "2026-09-07T00:00:00.000Z"
}
}
Body Parameters
string
required
The local-part of the email address (e.g.,
sales-rep).string
Human-readable display name for the inbox (e.g.,
Sales Representative).string
The ID of a verified custom domain. If omitted, the default domain is used.
Response
object
curl -X POST https://api.gork.email/v1/inboxes \
-H "Authorization: Bearer gork_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "sales-rep",
"name": "Sales Representative"
}'
{
"data": {
"id": "inb_89a0b12",
"address": "sales-rep@gork.email",
"name": "Sales Representative",
"isActive": true,
"createdAt": "2026-09-07T00:00:00.000Z"
}
}