Diese Seite wurde noch nicht in Ihre Sprache übersetzt. Angezeigt wird die Version Englisch (Vereinigtes Königreich).

Agency settings

Read and change your agency's public profile, AI settings, inbox intake, notification email, network page and website listing sources through the Fondaro API.

These routes let an organization admin's API key read and change the agency's settings: the ones an admin changes in Settings. A member's key gets 403 with ORG_ADMIN_REQUIRED on every route here. Reading needs crm:read; changing needs crm:write. Changing the website's listing sources also needs an active plan.

The same settings are available to AI clients through Fondaro MCP, with the same rules. Billing, API and MCP keys, integration credentials, phone numbers, the website's domain and publishing, connecting an inbox, team changes, and switching calling on or off stay in the dashboard.

Every change accepts only the fields listed: an unknown field is a 400, and the field rules are the dashboard's.

Get the public profile

GET /v1/agency/branding

What brochures, lead emails, the website and the network page show: every field in the table below, with null for a field not set.

Change the public profile

PATCH /v1/agency/branding

A change goes live at once. Fields you leave out stay as they are. Once saved, the agency must have a name and both logos. Answers the whole profile.

FieldTypeDescription
brandingNamestringThe agency name
brandingDescriptionstringWhat the agency does, in its own words
brandingLogoLightUrlstringLogo for light backgrounds. A new one remakes the dark logo unless the agency uploaded its own
brandingLogoDarkUrlstringLogo for dark backgrounds. "" makes it again from the light logo
brandingIconUrlstring or nullSquare icon (https), used as the favicon and the agency avatar. "" or null clears it
coverImageUrlstring or nullCover photo (https). "" or null clears it
accentColorstring or nullBrand colour, #rrggbb. "" or null clears it
brandingWebsitestringThe agency's own website
brandingEmail, brandingPhonestringPublic email and phone
brandingWhatsappstring or nullPublic WhatsApp number in international format (+34600000000)
brandingSocialsobjectOne https address per network: instagram, facebook, linkedin, youtube, tiktok, x. The whole set is replaced
brandingFoundedYearinteger or null1800 to 2100. 0 or null clears it
countryCode, city, brandingAddressstringWhere the agency is
languagesSpokenstring[]BCP 47 tags
specializationsstring[]What the agency does, from the services list. The whole list is replaced
automaticSalesEmailsEnabledbooleanWhether Fondaro sends automatic sales emails to leads
bash
curl -X PATCH https://api.fondaro.com/v1/agency/branding \  -H "Authorization: Bearer $FONDARO_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "brandingDescription": "Sales and rentals on the Costa del Sol since 2009.", "accentColor": "#1f6f5c" }'

Get the AI settings

GET /v1/agency/ai-settings

Answers both fields below.

Change the AI settings

PATCH /v1/agency/ai-settings

FieldTypeDescription
agentEnabledbooleanWhether Fondaro's assistant is on for the agency. Turning it on needs an active plan
callReviewModestringWhat happens after a call: manual (a review is offered) or off

Get who reaches the Inbox

GET /v1/agency/inbox-intake

Answers the three fields below.

Change who reaches the Inbox

PATCH /v1/agency/inbox-intake

For every inbox of the agency. A change applies to the next message; nothing already kept is removed. A PATCH with no field is a 400.

FieldTypeDescription
inboxIntakeModestringWho from outside the CRM reaches the Inbox: everyone, smart (kept unless the first message is clearly not about a home), or leads_only
inboxHistoryAllowedbooleanWhether inboxes may bring in past messages
inboxSharingAllowedbooleanWhether people may share their conversations with colleagues on the same lead

Get where the agency's email goes

GET /v1/agency/notification-channels

Where the agency's own email goes: invoices, receipts, payments, Growth, numbers and listings mail. With no primary email set, it goes to the first admin's sign-in email. The primary email is also the billing email: invoices and receipts go to it, and it is saved as the billing email with the payment provider.

Answers { "entries": [...], "resolvedPrimary": "office@example.com" }, where resolvedPrimary is where the email goes right now.

Replace where the agency's email goes

PUT /v1/agency/notification-channels

Replaces the whole list (up to 10 entries, at most one primary per type). A new primary email also becomes the billing email with the payment provider. Answers like the read.

json
{ "entries": [{ "type": "email", "value": "office@example.com", "enabled": true, "isPrimary": true }] }

Get the network page

GET /v1/agency/network-profile

Answers both fields below.

Change the network page

PATCH /v1/agency/network-profile

FieldTypeDescription
networkSlugstring or nullThe agency page's address on the agent network: 3 to 64 lower-case letters, digits or inner hyphens. It must be free; the old one stops working. null removes it
networkVisibilitystringWho may read the agency page

Get the website's listing sources

GET /v1/agency/website/listing-sources

Where the agency's website takes its homes from: { "selected", "available", "readiness" }, the sources listed in order, every source the website could list with its connection, and whether each is ready.

Replace the website's listing sources

PUT /v1/agency/website/listing-sources

Needs an active plan. Replaces the whole ordered list (1 to 5 entries, each source once), live on the next visit, with no rebuild. Answers like the read.

Sourceconfig
internal{ "scope": "own" } or { "scope": "own_and_network" }
resales_online{ "feed": "agency" } or { "feed": "own" }
inmobalia, zoddak{}
A portal{ "country": "es", "locations": [...] }, with 1 to 3 places

Each source must be connected. A refusal is a 400 with one of SITE_SOURCE_UNKNOWN, SITE_SOURCE_NOT_CONNECTED, SITE_SOURCE_NEEDS_MARKET, SITE_SOURCE_NOT_ALLOWED or SITE_SOURCE_LIMIT. An agency without a plan gets 403 with SUBSCRIPTION_REQUIRED.