This page hasn't been translated for your language. Showing the English (United Kingdom) version.
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.
| Field | Type | Description |
|---|---|---|
brandingName | string | The agency name |
brandingDescription | string | What the agency does, in its own words |
brandingLogoLightUrl | string | Logo for light backgrounds. A new one remakes the dark logo unless the agency uploaded its own |
brandingLogoDarkUrl | string | Logo for dark backgrounds. "" makes it again from the light logo |
brandingIconUrl | string or null | Square icon (https), used as the favicon and the agency avatar. "" or null clears it |
coverImageUrl | string or null | Cover photo (https). "" or null clears it |
accentColor | string or null | Brand colour, #rrggbb. "" or null clears it |
brandingWebsite | string | The agency's own website |
brandingEmail, brandingPhone | string | Public email and phone |
brandingWhatsapp | string or null | Public WhatsApp number in international format (+34600000000) |
brandingSocials | object | One https address per network: instagram, facebook, linkedin, youtube, tiktok, x. The whole set is replaced |
brandingFoundedYear | integer or null | 1800 to 2100. 0 or null clears it |
countryCode, city, brandingAddress | string | Where the agency is |
languagesSpoken | string[] | BCP 47 tags |
specializations | string[] | What the agency does, from the services list. The whole list is replaced |
automaticSalesEmailsEnabled | boolean | Whether Fondaro sends automatic sales emails to leads |
Get the AI settings
GET /v1/agency/ai-settings
Answers both fields below.
Change the AI settings
PATCH /v1/agency/ai-settings
| Field | Type | Description |
|---|---|---|
agentEnabled | boolean | Whether Fondaro's assistant is on for the agency. Turning it on needs an active plan |
callReviewMode | string | What 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.
| Field | Type | Description |
|---|---|---|
inboxIntakeMode | string | Who from outside the CRM reaches the Inbox: everyone, smart (kept unless the first message is clearly not about a home), or leads_only |
inboxHistoryAllowed | boolean | Whether inboxes may bring in past messages |
inboxSharingAllowed | boolean | Whether 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.
Get the network page
GET /v1/agency/network-profile
Answers both fields below.
Change the network page
PATCH /v1/agency/network-profile
| Field | Type | Description |
|---|---|---|
networkSlug | string or null | The 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 |
networkVisibility | string | Who 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.
| Source | config |
|---|---|
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.