Save Business Profile

Save or update the user’s business profile with provided details.

⚠️ IMPORTANT: This tool WRITES data. Use when user confirms their business profile.

🎯 What This Tool Does (Performance Agent - Phase 1 Feature 5):

Saves user’s business profile to database
Updates existing profile if one exists
Sets profile source as ‘user_confirmed’ or ‘user_mcp’
Enables personalized recommendations going forward

Required Parameters:

business_vertical: retail, services, technology, healthcare, finance, education, travel, food_beverage, automotive, real_estate
business_size: small (< $50K/month), medium ($ 50K- $500K/month), large (>$ 500K/month)
primary_goal: leads, sales, awareness, traffic, engagement, app_installs

Optional Parameters:

target_audience: Free-text description (e.g., “B2B enterprise clients”)
geographic_focus: local, regional, national, international
seasonality: none, holiday_heavy, summer_peak, winter_peak, q4_heavy, back_to_school
customer_id: Optional (uses connected account if omitted)

Use this tool when:

User provides their business details
User confirms an inferred profile
User wants to update their business profile
After asking user clarifying questions about their business

Example Usage: User: “I run a small local plumbing business targeting homeowners” → Call save_business_profile with:

business_vertical: “services”
business_size: “small”
primary_goal: “leads”
target_audience: “homeowners”
geographic_focus: “local”

Execution time: 1-2 seconds (database write)

POST

/

api

/

v1

/

tools

/

save_business_profile

/

execute

Save Business Profile

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/save_business_profile/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "business_size": "string",
    "business_vertical": "string",
    "customer_id": "string",
    "geographic_focus": "string",
    "primary_goal": "string",
    "seasonality": "string",
    "target_audience": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for save_business_profile)"
  },
  "success": true,
  "tool": "save_business_profile"
}

Authorizations

Authorization

string

header

required

API key from https://adspirer.ai/keys. Prefix sk_live_. Treat as a secret — never commit.

Headers

Idempotency-Key

string<uuid>

Client-generated UUID to make writes idempotent. Strongly recommended for write tools. A repeat call with the same key returns the cached result instead of re-executing. Example: 550e8400-e29b-41d4-a716-446655440000

Body

application/json

All tool arguments are wrapped in an arguments object. The fields accepted inside arguments are listed below — required fields are marked with a red asterisk.

arguments

object

required

Input schema for saving/updating business profile

Show child attributes

Response

Tool executed successfully. data.text carries the human-readable result (markdown-friendly). data.quota shows your current usage against the plan limit. data.structured appears when the tool emits machine-parseable structured content. data.content appears for tools that return non-text blocks (images, resources).

Returned on HTTP 200. data.text is the primary human-readable output. data.quota is always present for billable calls. data.structured is set only when the tool emits machine-parseable structured content. data.content is set only when the tool emits non-text content blocks.

data

object

required

Show child attributes

success

boolean

required

tool

string

required

Echoed tool_name from the request URL.

Last modified on April 23, 2026

Search AudiencesSearch for available audience segments (in-market, affinity, custom). Use this tool to discover audience segment IDs for: - **PMax campaigns:** Use IDs with `add_pmax_audience_signal` (audience signals/hints) - **Demand Gen / YouTube campaigns:** Pass IDs via `audience_segments` parameter in `create_demandgen_campaign` or `create_youtube_campaign` (direct targeting) **Audience types:** - **In-market:** Users actively researching products/services (e.g., "Business Software") - **Affinity:** Users with long-term interests (e.g., "Technology Enthusiasts") - **Custom:** Your account's existing remarketing/customer match lists **Parameters:** - query: Search term (e.g., "advertising services", "SaaS tools") **Execution time:** 2-5 seconds

Save Business Profile

curl --request POST \
  --url https://api.adspirer.ai/api/v1/tools/save_business_profile/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "arguments": {
    "business_size": "string",
    "business_vertical": "string",
    "customer_id": "string",
    "geographic_focus": "string",
    "primary_goal": "string",
    "seasonality": "string",
    "target_audience": "string"
  }
}
'

{
  "data": {
    "quota": {
      "limit": 150,
      "period_end": "2026-05-01",
      "tier": "plus",
      "used": 42
    },
    "text": "(tool-specific textual output for save_business_profile)"
  },
  "success": true,
  "tool": "save_business_profile"
}