Organization

Manage organization settings.

GET/api/v1/org/settings

Retrieve your organization's current settings, including name, default sender address, timezone, and mailing address.

Example

curl https://app.clawdmail.ai/api/v1/org/settings \
  -H "Authorization: Bearer cm_live_your_key"

Response

{
  "data": {
    "name": "Acme Inc.",
    "fromAddress": "hello@acme.com",
    "timezone": "America/New_York",
    "mailingAddress": "123 Main St, New York, NY 10001"
  }
}

PUT/api/v1/org/settings

Update your organization settings. Only include the fields you want to change.

Parameters

Name	Type	Description
`name`	string	Organization display name
`fromAddress`	string	Default sender email address for campaigns
`timezone`	string	IANA timezone string (e.g. "America/New_York")
`mailingAddress`	string	Physical mailing address — required for CAN-SPAM compliance

Example

curl -X PUT https://app.clawdmail.ai/api/v1/org/settings \
  -H "Authorization: Bearer cm_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Inc.",
    "fromAddress": "campaigns@acme.com",
    "timezone": "America/Los_Angeles"
  }'

Response

{
  "data": {
    "name": "Acme Inc.",
    "fromAddress": "campaigns@acme.com",
    "timezone": "America/Los_Angeles",
    "mailingAddress": "123 Main St, New York, NY 10001"
  }
}