Skip to main content
POST
/
creators
/
collabs
Create Collab
curl --request POST \
  --url https://unified-api.creatorcommerce.shop/creators/collabs \
  --header 'Content-Type: application/json' \
  --header 'x-channel-access-token: <api-key>' \
  --data '
{
  "myshopifyDomain": "cc-collabs-sandbox.myshopify.com",
  "email": "kenyon+test48548sep641@creatorcommerce.shop",
  "firstName": "Zeptio",
  "lastName": "Hombre",
  "affiliateCode": "TEST",
  "affiliateUrl": "https://test.com/TEST",
  "profilePicture": "https://picsum.photos/200/300",
  "primaryColor": "#66ccff",
  "title": "Blah",
  "custom": {
    "cc-ken-short-form": "cc-test1",
    "cc-cc-ken-long-form": "Hey everyone this is a super long field",
    "cc-ken-single-media": "https://fastly.picsum.photos/id/48/200/300.jpg?hmac=p1L57uKWk-HOLxkodQjf0Q4BpaqgWYhEgWyGaeIpG_k",
    "List of ken media": [
      "https://images.pexels.com/photos/31415546/pexels-photo-31415546.jpeg",
      "https://images.pexels.com/photos/16229208/pexels-photo-16229208.jpeg"
    ]
  }
}
'
{
  "collab": {
    "discount": {
      "discountAmount": 10,
      "discountType": "Percentage"
    },
    "_id": "68d482d502627cba69150a33",
    "channel": "67a93e156cc51f6c4e878e0c",
    "creator": "68d4828e02627cba69144aa2",
    "__v": 0,
    "affiliateCode": "TEST",
    "affiliateUrl": "https://test.com/TEST/",
    "collabTier": "68d46d30d78da92db6cad276",
    "createdAt": "2025-09-24T23:46:29.094Z",
    "drops": [],
    "isPartial": false,
    "relationshipManager": "creatorcommerce",
    "updatedAt": "2025-09-24T23:46:29.094Z"
  }
}

Authorizations

​
x-channel-access-token
string
header
required

Channel or partner access token (x-channel-access-token or x-partner-access-token)

Body

application/json
​
myshopifyDomain
string
required

The Shopify domain

​
email
string<email>
required

Creator email lookup key used to find or upsert the creator within myshopifyDomain.

​
firstName
string
required
​
lastName
string
required
​
handle
string
​
affiliateCode
string
​
affiliateUrl
string
​
collabTier
string
​
profilePicture
​
primaryColor
string

Hex color code

Pattern: ^#[0-9A-Fa-f]{6}$
​
title
string
​
custom
object

Custom fields for the collab

Response

200 - application/json

Successfully created collab

​
collab
object