Skip to main content
GET
/
integration
/
email-accounts
Get Email Accounts
curl --request GET \
  --url https://app.cardclan.io/api/integration/email-accounts \
  --header 'Authorization: Bearer <token>'
[
  {
    "key": "email-account",
    "choices": [
      {
        "key": "60f7b2b5b8f4a20015a4f5a6",
        "value": "hello@company.com",
        "label": "Email account",
        "id": "60f7b2b5b8f4a20015a4f5a6",
        "name": "hello@company.com"
      }
    ]
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.cardclan.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieves all email accounts configured for the user’s workspaces. Email accounts determine which “From” address will be used when sending cards via email.

​
Response Details

Returns an array containing email account choices formatted for integration platforms:
  • key: Always “email-account” to identify the data type
  • choices: Array of configured email accounts
Each email account includes:
  • id: Unique email account identifier
  • name: Email address (e.g., “hello@company.com”)
  • value: Same as name/email address
  • key: Same as ID
  • label: Description of the field type

​
Default Email Option

If you don’t want to use a specific email account, you can use "CardClan" as the emailAccount value in the Send Card endpoint to use CardClan’s default sending email.

​
Use Cases

  • Professional Sending: Send cards from your company’s email addresses
  • Brand Consistency: Maintain consistent sender identity across communications
  • Email Authentication: Improve deliverability with properly configured domains
  • User Choice: Let integration users select their preferred sending email

​
Example Response

[
  {
    "key": "email-account",
    "choices": [
      {
        "key": "60f7b2b5b8f4a20015a4f5a6",
        "value": "hello@company.com",
        "label": "Email account",
        "id": "60f7b2b5b8f4a20015a4f5a6",
        "name": "hello@company.com"
      },
      {
        "key": "60f7b2b5b8f4a20015a4f5a7",
        "value": "support@company.com",
        "label": "Email account",
        "id": "60f7b2b5b8f4a20015a4f5a7",
        "name": "support@company.com"
      }
    ]
  }
]

​
Configuration Requirements

Email accounts must be configured in your CardClan dashboard before they appear in this endpoint. The accounts need:
  • Verified Domain: Email domain must be verified
  • SMTP Configuration: Proper sending credentials configured
  • Workspace Access: Account must be associated with accessible workspaces

Authorizations

​
Authorization
string
header
required

Enter your CardClan integration key

Response

Email accounts retrieved successfully

​
key
string
Example:

"email-account"

​
choices
object[]