configurations

Update Integration Config

Update full integration configuration for an organization.

Expects the complete IntegrationConfig from the frontend.

put/configurations/{organization_id}

Path parameters

organization_idstring required

Request body

timezonestring

Timezone of the organization

org_tradesstring[]

Authoritative list of trades this organization operates in. Empty means trades are not configured.

partner_brand'praxis' nullable

Partner portfolio brand shown in the manager dashboard. None keeps standard NOSO branding.

holiday_suppression_enabledboolean

When True, automated customer messages are deferred on configured US/Canada holidays.

holiday_country'US' | 'CA' nullable

Holiday calendar country. If unset, inferred from the organization timezone and defaults to US.

holiday_regionstring nullable

Optional region/province code for holiday rules, e.g. QC for Quebec.

dashboard_variant'analytics' | 'noops'

Which dashboard renders at /dashboard for non-aspire orgs. Aspire orgs are derived separately.

MARKET_LEADS_ENABLEDboolean

When True, enables the market lead dashboard, workflows, and background sync for this organization.

MARKET_LEADS_BALLPARK_PRICING_ENABLEDboolean

When True, market lead prompts may discuss broad ballpark pricing after the homeowner asks.

MARKET_LEADS_SMS_SENDER_USER_IDstring nullable

Org-wide users.id used as the SMS sender for market lead conversations.

MARKET_LEADS_EMAIL_SENDER_ADDRESSstring nullable

Email address of a market-lead-connected inbox used to send (and capture replies for) market lead emails.

MARKET_LEADS_ST_BUSINESS_UNIT_NAMEstring nullable

Exact ServiceTitan business unit name for market lead jobs. Required before booking can run.

MARKET_LEADS_ST_JOB_TYPE_NAMEstring nullable

Exact ServiceTitan job type name for market lead jobs. Required before booking can run.

MARKET_LEADS_ST_JOB_ALERT_TO_NUMBERstring nullable

E.164 phone number that receives ServiceTitan booked-job alert SMS messages for market lead intake.

CAMPAIGNS_ENABLEDboolean

When True, enables the campaigns dashboard and the campaign API for this organization. Sole source of truth for campaign visibility; send-side guards are independent of it.

CAMPAIGNS_SMS_SENDER_USER_IDstring nullable

Org-wide users.id whose Twilio number sends campaign texts. Used when a campaign does not name its own sender.

CAMPAIGNS_SENDER_DISPLAY_NAMEstring nullable

First name the AI introduces itself with on campaign texts. Copied onto each new campaign as customer_facing_sender_name; without it the sender user's first name is used.

custom_databoolean

When True, enables org-specific custom processing at various pipeline stages. Off by default; toggle on per-integration as needed.

st_call_sync_enabledboolean

When True, the ServiceTitan telecom call ingestion CLI syncs this organization's office calls into st_calls.

st_data_source'direct' | 'make_primary' | 'reports_primary'

Where ServiceTitan reads come from: the direct API, or a staged source (Make lanes / ST scheduled reports; any direct ST client construction raises). What each staged source supports lives in services/st_etl/capabilities.py. Turning an org off is integrations.status, not this field.

st_reports_shadowboolean

When True, ST report drops are ingested into st_report_records for this org even though another lane still serves it. Read-only parity mode: never changes st_data_source, never refreshes org settings, never kicks the nightly sync.

st_require_feed_freshnessboolean

When True, the followup pipeline fails closed unless all Make-staged ST feeds cover the processing window.

Response

Successful Response

timezonestring

Timezone of the organization

org_tradesstring[]

Authoritative list of trades this organization operates in. Empty means trades are not configured.

partner_brand'praxis' nullable

Partner portfolio brand shown in the manager dashboard. None keeps standard NOSO branding.

holiday_suppression_enabledboolean

When True, automated customer messages are deferred on configured US/Canada holidays.

holiday_country'US' | 'CA' nullable

Holiday calendar country. If unset, inferred from the organization timezone and defaults to US.

holiday_regionstring nullable

Optional region/province code for holiday rules, e.g. QC for Quebec.

dashboard_variant'analytics' | 'noops'

Which dashboard renders at /dashboard for non-aspire orgs. Aspire orgs are derived separately.

MARKET_LEADS_ENABLEDboolean

When True, enables the market lead dashboard, workflows, and background sync for this organization.

MARKET_LEADS_BALLPARK_PRICING_ENABLEDboolean

When True, market lead prompts may discuss broad ballpark pricing after the homeowner asks.

MARKET_LEADS_SMS_SENDER_USER_IDstring nullable

Org-wide users.id used as the SMS sender for market lead conversations.

MARKET_LEADS_EMAIL_SENDER_ADDRESSstring nullable

Email address of a market-lead-connected inbox used to send (and capture replies for) market lead emails.

MARKET_LEADS_ST_BUSINESS_UNIT_NAMEstring nullable

Exact ServiceTitan business unit name for market lead jobs. Required before booking can run.

MARKET_LEADS_ST_JOB_TYPE_NAMEstring nullable

Exact ServiceTitan job type name for market lead jobs. Required before booking can run.

MARKET_LEADS_ST_JOB_ALERT_TO_NUMBERstring nullable

E.164 phone number that receives ServiceTitan booked-job alert SMS messages for market lead intake.

CAMPAIGNS_ENABLEDboolean

When True, enables the campaigns dashboard and the campaign API for this organization. Sole source of truth for campaign visibility; send-side guards are independent of it.

CAMPAIGNS_SMS_SENDER_USER_IDstring nullable

Org-wide users.id whose Twilio number sends campaign texts. Used when a campaign does not name its own sender.

CAMPAIGNS_SENDER_DISPLAY_NAMEstring nullable

First name the AI introduces itself with on campaign texts. Copied onto each new campaign as customer_facing_sender_name; without it the sender user's first name is used.

custom_databoolean

When True, enables org-specific custom processing at various pipeline stages. Off by default; toggle on per-integration as needed.

st_call_sync_enabledboolean

When True, the ServiceTitan telecom call ingestion CLI syncs this organization's office calls into st_calls.

st_data_source'direct' | 'make_primary' | 'reports_primary'

Where ServiceTitan reads come from: the direct API, or a staged source (Make lanes / ST scheduled reports; any direct ST client construction raises). What each staged source supports lives in services/st_etl/capabilities.py. Turning an org off is integrations.status, not this field.

st_reports_shadowboolean

When True, ST report drops are ingested into st_report_records for this org even though another lane still serves it. Read-only parity mode: never changes st_data_source, never refreshes org settings, never kicks the nightly sync.

st_require_feed_freshnessboolean

When True, the followup pipeline fails closed unless all Make-staged ST feeds cover the processing window.

operator_workflow_flagsobject

Derived from operator_config.workflow_flags(); response-only.

Changes

No recorded changes to this endpoint across all 1 revision of this API.