Get the organization's brand

Every plan. The builder theme and brand profile with their state: none (nothing saved), auto (applied by the automatic import when a domain was added, waiting for a review) or saved (saved or confirmed by a user). auto_import is the latest automatic import: pending, found (with the proposal in result, and applied when it became the theme) or failed with a reason: no_site, blocked, timeout, nothing_found or error. suggested_website is the address to prefill when importing by hand.

Every plan. Full access API keys. The builder theme and brand profile with their state (none: nothing saved; auto: applied by the automatic import when a sending domain was added, waiting for a review; saved: saved or confirmed by a user), the website to prefill in "Import brand from website", and the latest automatic import. Adding a domain to an organization without a saved theme reads its registrable parent domain (send.acme.com.br reads https://acme.com.br/, then https://www.acme.com.br/) in the background, once per parent domain, without AI. A brand found is applied only when nothing is saved, and never replaces a saved theme.

Authorization: Bearer pdg_…. An API key with full_access. A sending_access key gets 401 restricted_api_key.

#Request

This endpoint is not in the SDKs yet; call it over HTTP.

curl -X GET 'https://api.pidgely.com/brand' \
  -H "Authorization: Bearer $PIDGELY_API_KEY"

#Response

200 OK

{
  "object": "brand",
  "state": "auto",
  "theme": {
    "brand_color": "#2563eb",
    "text_color": "#0f172a",
    "background_color": "#f2f4f9",
    "content_color": "#ffffff",
    "button_text_color": "#ffffff",
    "font": "system",
    "web_font": "Poppins",
    "content_width": 600,
    "radius": 8,
    "logo_url": "https://api.pidgely.com/files/brand/8kQ2v1fWbqzJcR0mT5yH3xLa9sPn6dEe.png",
    "logo_width": 160,
    "logo_alt": "Acme",
    "logo_align": "left"
  },
  "theme_saved": true,
  "brand": {
    "name": "Acme",
    "website": "https://acme.com/",
    "socials": [
      {
        "network": "x",
        "url": "https://x.com/acme"
      }
    ],
    "imported_from": "https://acme.com/"
  },
  "brand_saved": true,
  "suggested_website": "https://acme.com/",
  "brand_import": true,
  "auto_import": {
    "object": "brand_auto_import",
    "id": "0199d7f8-1b2c-7d3e-8f4a-5b6c7d8e9f01",
    "domain": "acme.com",
    "source_domain": "send.acme.com",
    "status": "found",
    "reason": null,
    "url": "https://acme.com/",
    "applied": true,
    "dismissed": false,
    "created_at": "2026-10-12 16:44:41.000000+00",
    "finished_at": "2026-10-12 16:44:41.000000+00",
    "result": {
      "object": "brand_import",
      "url": "https://acme.com/",
      "name": "Acme",
      "…": "(same fields as Import brand)"
    }
  }
}

#Response fields

#Errors

Errors have the shape {"statusCode", "name", "message"}. See Errors for the full list.