Clerk

Clerk Email Addresses API

A user can be associated with one or more email addresses, which allows them to be contacted via email.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /email_addresses Add an email address to a user (backend) · Create an Email Address #
Ask an LLM
“How do I attach an extra email address to a user from my backend?”
“Can I add an email to a user already marked verified and primary?”
Tell an agent
Add email {email_address} to user {user_id}.
Add {email_address} to user {user_id} as a verified primary address.
GET /email_addresses/{email_address_id} Retrieve an email address by ID (backend) · Retrieve an Email Address #
Ask an LLM
“What are the details and verification state of an email address ID from the backend?”
“Can my server look up any user's email address record by its ID?”
Tell an agent
Retrieve email address {email_address_id}.
Show the verification status of email record {email_address_id}.
DELETE /email_addresses/{email_address_id} Delete any user's email address (backend) · Delete an Email Address #
Ask an LLM
“How does my backend remove an email address from a user's account?”
“Can a server-side call delete an email address by its ID?”
Tell an agent destructive · confirm first
Delete email address {email_address_id} using the backend API.
Remove email record {email_address_id} from its user server-side.
PATCH /email_addresses/{email_address_id} Mark an email address verified or primary · Update an Email Address #
Ask an LLM
“How do I mark a user's email address as verified from the backend?”
“Can I make a different email address the user's primary one?”
Tell an agent
Mark email address {email_address_id} as verified.
Make {email_address_id} the primary email address of its user.
GET /v1/me/email_addresses List the signed-in user's email addresses · Get Email Addresses #
Ask an LLM
“Which email addresses are on my own account?”
“Can the signed-in user see all their emails and which are verified?”
Tell an agent
List the email addresses on my account.
Show my email addresses for session {_clerk_session_id}.
POST /v1/me/email_addresses Add an email address to my own account · Create Email Address #
Ask an LLM
“How do I add another email address to my own account?”
“Does a newly added email need to be verified before it's usable?”
Tell an agent
Add {email_address} to my account.
Attach {email_address} to the signed-in user so I can verify it next.
POST /v1/me/email_addresses/{email_id}/attempt_verification Submit the code to verify my email address · Attempt Email Address Verification #
Ask an LLM
“I got a verification code by email, how do I confirm my new address?”
“What do I send to complete verification of an email I added to my account?”
Tell an agent
Verify my email address {email_id} with code {code}.
Submit code {code} to confirm email {email_id}.
POST /v1/me/email_addresses/{email_id}/prepare_verification Send a verification code or link to my email · Prepare Email Address Verification #
Ask an LLM
“How do I get a verification code sent to an email address I just added?”
“Can I verify my email with a magic link instead of a code?”
Tell an agent
Send a verification email to my address {email_id} using {strategy}.
Email a verification link for {email_id} that returns to {redirect_url}.
GET /v1/me/email_addresses/{email_id} Get one of my email addresses · Get Email Address #
Ask an LLM
“Can I check whether one of my own email addresses has been verified?”
“What details are stored for a specific email on my account?”
Tell an agent
Get my email address {email_id}.
Show the verification status of my email {email_id}.
DELETE /v1/me/email_addresses/{email_id} Remove an email address from my account · Delete Email Address #
Ask an LLM
“How do I remove an old email address from my own account?”
“Can the signed-in user delete one of their emails?”
Tell an agent destructive · confirm first
Remove email {email_id} from my account.
Delete my own email address {email_id}.

Documentation

📖
Documentation
https://clerk.com/docs/reference/backend-api
📖
APIReference
https://clerk.com/docs/reference/backend-api
📖
GettingStarted
https://clerk.com/docs/quickstarts/overview
📖
Authentication
https://clerk.com/docs/backend-requests/making/jwt-templates
📖
Documentation
https://clerk.com/docs
📖
Documentation
https://clerk.com/docs/webhooks/overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/clerk-com/refs/heads/main/openapi/clerk-com-email-addresses-api-openapi.yml

Other Resources

🔗
SpectralRuleset
https://raw.githubusercontent.com/api-evangelist/clerk-com/refs/heads/main/rules/clerk-rules.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clerk-com-email-addresses-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clerk-com-email-addresses-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Clerk Com Email Addresses API
  termsOfService: https://clerk.com/terms
  x-logo:
    url: https://clerk.com/_next/image?url=%2Fimages%2Fclerk-logo.svg&w=96&q=75
    altText: Clerk docs
    href: https://clerk.com/docs
  version: '1.0'
  description: 'Operations tagged Email Addresses across 2 of this provider''s published API definitions: clerk-backend-api-openapi.yml, clerk-frontend-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.clerk.com/v1
- url: https://{domain}.clerk.accounts.dev
  variables:
    domain:
      default: example-destined-camel-13
      description: Your Development Instance Frontend API Domain.
tags:


# --- truncated at 32 KB (75 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/clerk-com/refs/heads/main/openapi/clerk-com-email-addresses-api-openapi.yml