Settings

Settings store your DealDome configuration as key-value pairs. This includes API keys for third-party integrations, Shopify store configuration, Telegram notification settings, and other account-level preferences. Changes take effect immediately across all services.

Settings endpoints require the admin scope. Be careful when updating — some keys (like API credentials) are sensitive and affect live integrations.

GET/settings

Get settings

This endpoint returns all current settings for your DealDome account. Sensitive values like API keys are partially masked in the response.

Request

GET

/settings

curl https://api.dealdome.eu/settings \
  -H "Authorization: Bearer {token}"

Response

{
  "data": {
    "shopify": {
      "store_url": "my-store.myshopify.com",
      "api_key": "shpat_****...3f2a",
      "sync_enabled": true
    },
    "meta": {
      "access_token": "EAABsb****...Qx2",
      "ad_account_id": "act_123456789",
      "sync_enabled": true
    },
    "telegram": {
      "bot_token": "7012****:AAH****...kPw",
      "chat_id": "-1001234567890",
      "notifications_enabled": true,
      "daily_report_time": "09:00"
    },
    "currency": "EUR",
    "timezone": "Europe/Amsterdam"
  }
}

PUT/settings

Update settings

This endpoint lets you update one or more settings. Pass only the keys you want to change — unspecified keys remain untouched. You can update nested objects like shopify or telegram by passing the full object.

Optional attributes

Name
shopify
Type
object
Description
Shopify store configuration — includes store_url, api_key, and sync_enabled.
Name
meta
Type
object
Description
Meta Ads API configuration — includes access_token, ad_account_id, and sync_enabled.
Name
telegram
Type
object
Description
Telegram bot settings — includes bot_token, chat_id, notifications_enabled, and daily_report_time.
Name
currency
Type
string
Description
Default currency for the account — e.g., EUR or USD.
Name
timezone
Type
string
Description
Timezone for reports and scheduled tasks — e.g., Europe/Amsterdam.

Request

PUT

/settings

curl -X PUT https://api.dealdome.eu/settings \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "telegram": {
      "bot_token": "7012345678:AAHxyz...",
      "chat_id": "-1001234567890",
      "notifications_enabled": true,
      "daily_report_time": "08:00"
    },
    "timezone": "Europe/Amsterdam"
  }'

Response

{
  "data": {
    "shopify": {
      "store_url": "my-store.myshopify.com",
      "api_key": "shpat_****...3f2a",
      "sync_enabled": true
    },
    "meta": {
      "access_token": "EAABsb****...Qx2",
      "ad_account_id": "act_123456789",
      "sync_enabled": true
    },
    "telegram": {
      "bot_token": "7012****:AAH****...kPw",
      "chat_id": "-1001234567890",
      "notifications_enabled": true,
      "daily_report_time": "08:00"
    },
    "currency": "EUR",
    "timezone": "Europe/Amsterdam"
  }
}