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"
      }
    ]
  }
]
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[]