ClawEmail

Provision and manage @clawemail.com Google Workspace email accounts for AI agents. Each account comes with full Gmail, Docs, Sheets, Calendar, and Drive access plus OAuth credentials for programmatic use.

Setup

Set your API key as an environment variable:

export CLAWEMAIL_API_KEY=your_api_key_here

Base URL: https://clawemail.com

All admin endpoints require the header: -H "X-API-Key: $CLAWEMAIL_API_KEY"

Check Email Availability (Public — no API key needed)

Before creating an account, always check if the prefix is available:

curl -s https://clawemail.com/check/DESIRED_PREFIX

Response when available:

{"prefix":"tom","email":"[email protected]","available":true}

Response when taken or reserved:

{"available":false,"errors":["This email is reserved"]}

Create Email Account

Provisions a new @clawemail.com Google Workspace user. Returns a temporary password and an OAuth connect URL.

curl -s -X POST https://clawemail.com/api/emails \
  -H "X-API-Key: $CLAWEMAIL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prefix":"DESIRED_PREFIX"}'

Response:

{
  "success": true,
  "email": "[email protected]",
  "password": "aB3$xYz...",
  "connect_url": "https://clawemail.com/connect/tom",
  "instructions": "1. User logs into Gmail with the email/password above. 2. User visits connect_url to authorize OAuth. 3. User receives their OpenClaw credentials."
}

Important: Save the password immediately — it is shown only once.

After creation, the user must:

1. Log in to Gmail at https://mail.google.com with the new email and password
2. Visit the connect_url to authorize OAuth and receive their credentials JSON

List All Emails

curl -s https://clawemail.com/api/emails \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Supports pagination with ?limit=100&offset=0.

Get Email Details

curl -s https://clawemail.com/api/emails/PREFIX \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Returns email status, creation date, OAuth connection date, and Workspace user details.

Suspend Email

Temporarily disables a Google Workspace account (preserves data):

curl -s -X POST https://clawemail.com/api/emails/PREFIX/suspend \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Unsuspend Email

Re-enables a previously suspended account:

curl -s -X POST https://clawemail.com/api/emails/PREFIX/unsuspend \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Delete Email

Permanently deletes the Google Workspace account and all associated data:

curl -s -X DELETE https://clawemail.com/api/emails/PREFIX \
  -H "X-API-Key: $CLAWEMAIL_API_KEY"

Self-Service Signup (No API Key)

For users who want to sign up themselves through Stripe checkout: