Actions16
Location (Sub-Account) → Create
AI-generatedSummary
Create a Boomerang sub-account under the agency, optionally setting its business details, owner contact, account settings, social profiles, Mailgun credentials, and snapshot.
Inputs
- Sub-Account Name (required) — Business name shown in Boomerang.
- Address, City, State, Country, Postal Code — Optional location details. Country is validated as an ISO 3166-1 alpha-2 code; common aliases such as USA, UK, and Canada are converted, while unrecognized values cause an error.
- Timezone — Optional IANA timezone selected from the available list; defaults to America/New_York.
- Owner First Name, Owner Last Name, Owner Email — Together, these set the primary contact in prospectInfo. All three must be provided or the owner contact is omitted. The legacy Prospect First Name, Prospect Last Name, and Prospect Email additional fields override these values when set.
- Owner Phone — Optional primary contact phone; E.164 format is preferred.
- Website — Optional business website URL.
- Snapshot — Optional snapshot selected from the agency's runtime list. The operation checks the ID against that list when available; a non-empty list that does not contain the ID causes an error.
- Additional Fields — Optionally override the company ID from the OAuth credential, set account settings, provide social profile links and Google Places ID, and configure Mailgun. Mailgun is included only when both API key and domain are set.
Output shape
A single sub-account record per input item.
Returns the created location object, unwrapping a location response envelope if present. Blank optional scalar fields are omitted. Requires the Boomerang agency OAuth2 credential; the company ID comes from that credential unless overridden. If snapshot listing fails or returns no snapshots, snapshot ID validation is skipped.