Skip to main content
POST
/
influencers
Create Influencer
curl --request POST \
  --url https://api.supapost.so/influencers \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "style": "<string>",
  "model": "<string>",
  "images": [
    "<string>"
  ],
  "traits": {}
}
'
{
  "id": "inf-uuid",
  "team_id": "team-uuid",
  "name": "Ava Chen",
  "description": "Fitness and wellness influencer",
  "style": "realistic",
  "model": "fal:flux-pro",
  "avatar_url": "https://cdn.supapost.so/assets/team/ava-1.jpg",
  "images": [
    "https://cdn.supapost.so/assets/team/ava-1.jpg",
    "https://cdn.supapost.so/assets/team/ava-2.jpg"
  ],
  "metadata": {
    "traits": {
      "gender": "female",
      "ageRange": "25-30",
      "ethnicity": "East Asian",
      "skinTone": "light",
      "faceShape": "oval",
      "jawline": "soft",
      "eyeColor": "brown",
      "eyeShape": "almond",
      "noseShape": "small",
      "lipShape": "full",
      "facialHair": "none",
      "hairColor": "black",
      "hairStyle": "straight",
      "hairLength": "long",
      "bodyType": "athletic",
      "height": "tall",
      "tattoos": "none",
      "piercings": "ears",
      "glasses": "none",
      "clothingStyle": "athleisure",
      "expression": "confident smile",
      "pose": "standing",
      "lighting": "natural",
      "background": "gym"
    }
  },
  "created_by": "user-uuid",
  "created_at": "2026-04-08T10:00:00Z",
  "updated_at": null
}
Creates an AI influencer persona with reference images and optional personality traits. The first image in the array is used as the avatar.

​
Authentication

​
Authorization
string
Bearer token. Bearer <supabase-jwt>.

​
Body

​
name
string
required
Display name for the influencer.
​
description
string
required
A description of the influencer persona.
​
style
string
default:"realistic"
Image generation style, e.g. "realistic", "anime", "3d".
​
model
string
AI model identifier for generating images of this influencer.
​
images
string[]
required
Array of reference image URLs. The first image is used as the avatar.
​
traits
object
Physical and stylistic traits for the influencer. Available fields (all strings): gender, ageRange, ethnicity, skinTone, faceShape, jawline, eyeColor, eyeShape, noseShape, lipShape, facialHair, hairColor, hairStyle, hairLength, bodyType, height, tattoos, piercings, glasses, clothingStyle, expression, pose, lighting, background.
{
  "id": "inf-uuid",
  "team_id": "team-uuid",
  "name": "Ava Chen",
  "description": "Fitness and wellness influencer",
  "style": "realistic",
  "model": "fal:flux-pro",
  "avatar_url": "https://cdn.supapost.so/assets/team/ava-1.jpg",
  "images": [
    "https://cdn.supapost.so/assets/team/ava-1.jpg",
    "https://cdn.supapost.so/assets/team/ava-2.jpg"
  ],
  "metadata": {
    "traits": {
      "gender": "female",
      "ageRange": "25-30",
      "ethnicity": "East Asian",
      "skinTone": "light",
      "faceShape": "oval",
      "jawline": "soft",
      "eyeColor": "brown",
      "eyeShape": "almond",
      "noseShape": "small",
      "lipShape": "full",
      "facialHair": "none",
      "hairColor": "black",
      "hairStyle": "straight",
      "hairLength": "long",
      "bodyType": "athletic",
      "height": "tall",
      "tattoos": "none",
      "piercings": "ears",
      "glasses": "none",
      "clothingStyle": "athleisure",
      "expression": "confident smile",
      "pose": "standing",
      "lighting": "natural",
      "background": "gym"
    }
  },
  "created_by": "user-uuid",
  "created_at": "2026-04-08T10:00:00Z",
  "updated_at": null
}