Skip to main content
POST
/
brand-story-create
Create brand story
curl --request POST \
  --url https://api.jackson.scope3.com/brand-story-create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "brandAgentId": "<string>",
  "name": "<string>",
  "prompt": "<string>",
  "countries": [
    "<string>"
  ],
  "channels": [
    "<string>"
  ],
  "languages": [
    "<string>"
  ],
  "brands": [
    "<string>"
  ]
}'
{
  "success": true,
  "message": "<string>",
  "data": {}
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication using Scope3 API key

Body

application/json
​
brandAgentId
string
required

ID of the brand agent to create a brand story for

​
name
string
required

Name for the brand story (e.g., 'Tech Enthusiasts', 'Luxury Shoppers')

​
prompt
string
required

Natural language prompt defining the target audience profile, demographics, and behavioral characteristics

​
countries
string[]

List of country codes to target (e.g., ['US', 'CA'])

​
channels
string[]

List of channels to target (e.g., ['web', 'social'])

​
languages
string[]

List of language codes to target (e.g., ['en', 'es'])

​
brands
string[]

List of specific brands this applies to

Response

Successful tool execution

​
success
boolean

Whether the operation succeeded

​
message
string

Human-readable response message

​
data
object

Response data (varies by tool)

⌘I