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