curl -X POST https://api.gork.email/v1/messages/send \
-H "Authorization: Bearer gk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inboxId": "inbox_728af980b4e",
"to": ["prospect@acmecorp.com"],
"subject": "Quick question regarding agent fleet scaling",
"text": "Hi Alex,\n\nI noticed you are scaling your customer support agents..."
}'
import { GorkClient } from "@gorkmail/sdk"
const client = new GorkClient({ apiKey: process.env.GORK_API_KEY })
const message = await client.messages.send({
inboxId: "inbox_728af980b4e",
to: ["prospect@acmecorp.com"],
subject: "Quick question regarding agent fleet scaling",
text: "Hi Alex,\n\nI noticed you are scaling your customer support agents..."
})
from gorkmail import GorkClient
client = GorkClient(api_key="gk_live_YOUR_API_KEY")
message = client.messages.send(
inbox_id="inbox_728af980b4e",
to=["prospect@acmecorp.com"],
subject="Quick question regarding agent fleet scaling",
text="Hi Alex,\n\nI noticed you are scaling your customer support agents..."
)
{
"data": {
"id": "msg_90e38dfb4a2c",
"threadId": "thrd_128bca90f4",
"inboxId": "inbox_728af980b4e",
"direction": "outbound",
"status": "sent",
"createdAt": "2026-09-07T12:00:00.000Z"
}
}
Messages
Send Message
Send an outbound email or automated reply from any active inbox.
POST
/
v1
/
messages
/
send
curl -X POST https://api.gork.email/v1/messages/send \
-H "Authorization: Bearer gk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inboxId": "inbox_728af980b4e",
"to": ["prospect@acmecorp.com"],
"subject": "Quick question regarding agent fleet scaling",
"text": "Hi Alex,\n\nI noticed you are scaling your customer support agents..."
}'
import { GorkClient } from "@gorkmail/sdk"
const client = new GorkClient({ apiKey: process.env.GORK_API_KEY })
const message = await client.messages.send({
inboxId: "inbox_728af980b4e",
to: ["prospect@acmecorp.com"],
subject: "Quick question regarding agent fleet scaling",
text: "Hi Alex,\n\nI noticed you are scaling your customer support agents..."
})
from gorkmail import GorkClient
client = GorkClient(api_key="gk_live_YOUR_API_KEY")
message = client.messages.send(
inbox_id="inbox_728af980b4e",
to=["prospect@acmecorp.com"],
subject="Quick question regarding agent fleet scaling",
text="Hi Alex,\n\nI noticed you are scaling your customer support agents..."
)
{
"data": {
"id": "msg_90e38dfb4a2c",
"threadId": "thrd_128bca90f4",
"inboxId": "inbox_728af980b4e",
"direction": "outbound",
"status": "sent",
"createdAt": "2026-09-07T12:00:00.000Z"
}
}
Dispatch an email message from one of your provisioned inboxes. The outbound message is automatically signed with your organization’s DKIM keys and wrapped in loop-suppression headers to prevent infinite mail loops.
Headers
string
required
Bearer token formatted as
Bearer gk_live_... or scoped inbox key Bearer gk_box_....string
Optional unique UUID string (max 255 chars) to prevent double sending on network retry.
Body
string
required
The unique ID of the inbox sending the email (e.g.
inbox_8f29ac01...).string[]
required
Array of recipient email addresses. Max 50 recipients per request.
string
default:"(no subject)"
The subject line of the email. Max 500 characters.
string
Plain text body of the email.
string
Rich HTML body. Automatically sanitized before dispatch.
string[]
Array of CC recipient email addresses.
string[]
Array of BCC recipient email addresses.
string
Optional message or thread ID to preserve email threading and headers (
In-Reply-To, References).Response
object
curl -X POST https://api.gork.email/v1/messages/send \
-H "Authorization: Bearer gk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"inboxId": "inbox_728af980b4e",
"to": ["prospect@acmecorp.com"],
"subject": "Quick question regarding agent fleet scaling",
"text": "Hi Alex,\n\nI noticed you are scaling your customer support agents..."
}'
import { GorkClient } from "@gorkmail/sdk"
const client = new GorkClient({ apiKey: process.env.GORK_API_KEY })
const message = await client.messages.send({
inboxId: "inbox_728af980b4e",
to: ["prospect@acmecorp.com"],
subject: "Quick question regarding agent fleet scaling",
text: "Hi Alex,\n\nI noticed you are scaling your customer support agents..."
})
from gorkmail import GorkClient
client = GorkClient(api_key="gk_live_YOUR_API_KEY")
message = client.messages.send(
inbox_id="inbox_728af980b4e",
to=["prospect@acmecorp.com"],
subject="Quick question regarding agent fleet scaling",
text="Hi Alex,\n\nI noticed you are scaling your customer support agents..."
)
{
"data": {
"id": "msg_90e38dfb4a2c",
"threadId": "thrd_128bca90f4",
"inboxId": "inbox_728af980b4e",
"direction": "outbound",
"status": "sent",
"createdAt": "2026-09-07T12:00:00.000Z"
}
}