logo
Handle APICreate a handle for the API key owner

Create a handle for the API key owner

Creates a handle immediately without email confirmation. The handle's destination is set to the API key owner's email.

curl -X POST "https://mail.haltman.io/api/handle/create" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "handle": "example_string"
}'
{
  "ok": true,
  "created": true,
  "handle": "example_string",
  "goto": "user@example.com"
}
POST
/api/handle/create
POST
API Key (header: X-API-Key)
X-API-Keystring
Required

64-character lowercase hexadecimal API key.

64-character lowercase hexadecimal API key.
Content-Typestring
Required

The media type of the request body

Options: application/json
handlestring
Required

The local-part to claim.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. 64-character lowercase hexadecimal API key.

Body

application/json
handlestring
Required

The local-part to claim.

Responses

okboolean
Required
createdboolean
Required
handlestring
Required
gotostring
Required