Account

Manage the authenticated user's own account. An account represents an organization on the platform with its own contacts, campaigns, and settings. Use these endpoints to view or update account details, address, and domains. To manage sub-accounts under a partner account, see the Sub-Account endpoints.

Show my account details

GET

https://api.cakemail.dev

/accounts/self

Retrieve the full details of the authenticated user's account, including name, address, contact information, usage limits, feature flags, and domain configuration.

Required scope(s): any_authenticated_pat

Show my account details › Responses

Successful Response

AccountResponse

AccountFullResponse · required

GET/accounts/self

curl https://api.cakemail.dev/accounts/self \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "id": "id",
    "lineage": "lineage",
    "status": "trial",
    "name": "name",
    "address": {
      "address1": "address1",
      "address2": "address2",
      "city": "city",
      "country": "country",
      "province": "province",
      "postal_code": "postal_code"
    },
    "account_owner": {
      "user_id": "user_id"
    },
    "fax": "fax",
    "phone": "phone",
    "website": "website",
    "logo": "logo",
    "usage_limits": {
      "starts_on": 0,
      "per_campaign": 0,
      "per_month": 0,
      "remaining": 0,
      "maximum_contacts": 0,
      "lists": 0,
      "users": 0,
      "campaign_blueprints": 0,
      "automation_conditions": 0,
      "use_ab_split": true,
      "use_automation_conditions": true,
      "use_automations": true,
      "use_automation_customwebhooks": true,
      "use_behavioral_segmentation": true,
      "use_brand": true,
      "use_campaign_blueprints": true,
      "use_contact_export": true,
      "use_custom_merge_tags": true,
      "use_email_api": true,
      "use_html_editor": true,
      "use_list_redirection": true,
      "use_smart_email_resource": true,
      "use_smart_blueprint": true,
      "use_tags_in_automation": true,
      "use_tags": true,
      "insert_reseller_logo": true,
      "use_forms": true,
      "use_popups": true,
      "use_pages": true,
      "use_pages_redirection": true,
      "use_ai_generation": true
    },
    "last_activity_on": 0,
    "created_on": 0,
    "partner": true,
    "organization": true,
    "stripe_customer_id": "stripe_customer_id",
    "overrides": {
      "bypass_recaptcha": true,
      "inject_address": true,
      "inject_unsubscribe_link": true
    },
    "metadata": {}
  }
}

json

application/json

Update my account

PATCH

https://api.cakemail.dev

/accounts/self

Update the authenticated user's account. All fields are optional — only provided fields are updated. The address is validated against a geocoding service; if the provided address differs from the geocoded result, warnings with suggested corrections are included in the response.

Required scope(s): account:write

Update my account › Request Body

PatchSelfAccount

object

Mailing address of the account

name

string

Account display name

object

User to set as account owner

fax

string

phone

string

object

Custom domain configuration

Default: {}

website

string · uri · minLength: 1 · maxLength: 2083

Account website URL

Update my account › Responses

Successful Response

PatchAccountResponse

AccountFullResponse · required

object[]

Default: []

PATCH/accounts/self

curl https://api.cakemail.dev/accounts/self \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "address": {
    "address1": "address1",
    "address2": "address2",
    "city": "city",
    "country": "country",
    "province": "province",
    "postal_code": "postal_code"
  },
  "name": "name",
  "account_owner": {
    "user_id": 1
  },
  "fax": "fax",
  "phone": "phone",
  "domains": {},
  "website": "https://www.example.com/path/to/resource"
}'

Example Request Body

{
  "address": {
    "address1": "address1",
    "address2": "address2",
    "city": "city",
    "country": "country",
    "province": "province",
    "postal_code": "postal_code"
  },
  "name": "name",
  "account_owner": {
    "user_id": 1
  },
  "fax": "fax",
  "phone": "phone",
  "domains": {},
  "website": "https://www.example.com/path/to/resource"
}

json

Example Responses

{
  "data": {
    "id": "id",
    "lineage": "lineage",
    "status": "trial",
    "name": "name",
    "address": {
      "address1": "address1",
      "address2": "address2",
      "city": "city",
      "country": "country",
      "province": "province",
      "postal_code": "postal_code"
    },
    "account_owner": {
      "user_id": "user_id"
    },
    "fax": "fax",
    "phone": "phone",
    "website": "website",
    "logo": "logo",
    "usage_limits": {
      "starts_on": 0,
      "per_campaign": 0,
      "per_month": 0,
      "remaining": 0,
      "maximum_contacts": 0,
      "lists": 0,
      "users": 0,
      "campaign_blueprints": 0,
      "automation_conditions": 0,
      "use_ab_split": true,
      "use_automation_conditions": true,
      "use_automations": true,
      "use_automation_customwebhooks": true,
      "use_behavioral_segmentation": true,
      "use_brand": true,
      "use_campaign_blueprints": true,
      "use_contact_export": true,
      "use_custom_merge_tags": true,
      "use_email_api": true,
      "use_html_editor": true,
      "use_list_redirection": true,
      "use_smart_email_resource": true,
      "use_smart_blueprint": true,
      "use_tags_in_automation": true,
      "use_tags": true,
      "insert_reseller_logo": true,
      "use_forms": true,
      "use_popups": true,
      "use_pages": true,
      "use_pages_redirection": true,
      "use_ai_generation": true
    },
    "last_activity_on": 0,
    "created_on": 0,
    "partner": true,
    "organization": true,
    "stripe_customer_id": "stripe_customer_id",
    "overrides": {
      "bypass_recaptcha": true,
      "inject_address": true,
      "inject_unsubscribe_link": true
    },
    "metadata": {}
  },
  "warnings": []
}

json

application/json

Convert my account to an Organization

POST

https://api.cakemail.dev

/accounts/self/convert-to-organization

Convert the authenticated user's account into an organization. An organization account can create and manage sub-accounts, each with their own users, contacts, and campaigns. This operation is irreversible.

Required scope(s): account:write

Convert my account to an Organization › Responses

Successful Response

AccountResponse

AccountFullResponse · required

POST/accounts/self/convert-to-organization

curl https://api.cakemail.dev/accounts/self/convert-to-organization \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": {
    "id": "id",
    "lineage": "lineage",
    "status": "trial",
    "name": "name",
    "address": {
      "address1": "address1",
      "address2": "address2",
      "city": "city",
      "country": "country",
      "province": "province",
      "postal_code": "postal_code"
    },
    "account_owner": {
      "user_id": "user_id"
    },
    "fax": "fax",
    "phone": "phone",
    "website": "website",
    "logo": "logo",
    "usage_limits": {
      "starts_on": 0,
      "per_campaign": 0,
      "per_month": 0,
      "remaining": 0,
      "maximum_contacts": 0,
      "lists": 0,
      "users": 0,
      "campaign_blueprints": 0,
      "automation_conditions": 0,
      "use_ab_split": true,
      "use_automation_conditions": true,
      "use_automations": true,
      "use_automation_customwebhooks": true,
      "use_behavioral_segmentation": true,
      "use_brand": true,
      "use_campaign_blueprints": true,
      "use_contact_export": true,
      "use_custom_merge_tags": true,
      "use_email_api": true,
      "use_html_editor": true,
      "use_list_redirection": true,
      "use_smart_email_resource": true,
      "use_smart_blueprint": true,
      "use_tags_in_automation": true,
      "use_tags": true,
      "insert_reseller_logo": true,
      "use_forms": true,
      "use_popups": true,
      "use_pages": true,
      "use_pages_redirection": true,
      "use_ai_generation": true
    },
    "last_activity_on": 0,
    "created_on": 0,
    "partner": true,
    "organization": true,
    "stripe_customer_id": "stripe_customer_id",
    "overrides": {
      "bypass_recaptcha": true,
      "inject_address": true,
      "inject_unsubscribe_link": true
    },
    "metadata": {}
  }
}

json

application/json

Personal Access Tokens User