InboxKit
  1. Mailboxes
InboxKit
  • Introduction
  • Account
    • Get account details
      GET
  • Workspaces
    • List workspaces
      GET
    • Get workspace details
      GET
    • Create workspace
      POST
    • Update workspace
      PUT
    • Delete workspace
      DELETE
    • Update workspace webhook
      POST
  • Domains
    • Search available domains
      POST
    • Check if domain is banned from registration
      GET
    • Check domain availability
      GET
    • Register domains
      POST
    • List domains
      GET
    • List assignable domains
      GET
    • Set DMARC policy
      POST
    • Remove DMARC policy
      DELETE
    • Remove domains
      POST
    • Set domain forwarding
      POST
    • Set email forwarding
      POST
    • Remove email forwarding
      DELETE
    • Set catch-all email
      POST
    • Remove catch-all email
      DELETE
    • Get nameservers for domain connection
      POST
    • Check nameservers propagation
      POST
  • Mailboxes
    • List mailboxes
      GET
    • Show mailbox credentials
      GET
    • Get mailbox details
      GET
    • Buy mailboxes
      POST
    • Check mailbox status
      POST
    • Cancel mailboxes
      POST
    • Update mailbox
      POST
    • Update mailbox profile picture
      POST
    • Generate TOTP
      GET
    • Change username
      POST
    • Change password
      POST
    • Check mailbox availability
      GET
  • DNS
    • Get DNS records
    • Add DNS records
    • Update DNS records
    • Delete DNS records
  • Sequencers
    • Export mailboxes status
    • List sequencer platforms
    • List sequencers
    • Export mailboxes
    • Add sequencer
    • Update sequencer
    • Delete sequencers
  • Billing
    • Get pricing plans
    • Get subscription details
    • Change subscription plan
    • Cancel subscription
    • Get wallet details
    • Add credits to wallet
    • Update auto top-up settings
    • Get billing portal link
  1. Mailboxes

Buy mailboxes

POST
https://api.inboxkit.com/v1/api/mailboxes/buy
Mailboxes
Maintainer:Not configured
Purchase mailboxes for specified domains
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.inboxkit.com/v1/api/mailboxes/buy' \
--header 'X-Workspace-Id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uids": [
        "string"
    ],
    "mailboxes": [
        {
            "first_name": "John",
            "last_name": "Doe",
            "profile_picture": "string",
            "username": "john.doe",
            "platform": "GOOGLE"
        }
    ]
}'
Response Response Example
{
    "error": false,
    "message": "Mailbox details retrieved successfully",
    "mailboxes": [
        {
            "uid": "string",
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "platform": "string",
            "domain": "string"
        }
    ]
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
X-Workspace-Id
string <uuid>
required
Workspace identifier
Body Params application/json
uids
array[string]
required
Domain UIDs to create mailboxes for
mailboxes
array [object {5}] 
required
Mailbox configurations
first_name
string 
required
Example:
John
last_name
string 
required
Example:
Doe
profile_picture
string  | null 
optional
Profile picture URL
username
string 
required
Example:
john.doe
platform
enum<string> 
required
Allowed values:
GOOGLEMICROSOFT
Default:
GOOGLE
Examples

Responses

🟢200OK
application/json
Mailboxes created successfully
Body
error
boolean 
optional
Example:
false
message
string 
optional
Example:
Mailbox details retrieved successfully
mailboxes
array [object {6}] 
optional
Created mailboxes
uid
string 
optional
first_name
string 
optional
last_name
string 
optional
username
string 
optional
platform
string 
optional
domain
string 
optional
🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Modified at 2025-06-20 08:04:06
Previous
Get mailbox details
Next
Check mailbox status
Built with