Skip to main content
POST
Create a challenge in a community

Authorizations

Authorization
string
header
required

Bearer credential for the public API. Send a live COPE API key (cope_sk_live_*), or a Clerk session token when acting as a signed-in user. Community operations are scoped to the authenticated user; include X-Cope-Business-Id to act on behalf of a specific business you own.

Path Parameters

id
string
required
Pattern: ^[A-Za-z0-9_-]+$

Body

application/json
cp_reward
integer
required
Required range: x >= 0
ends_at
string<date-time>
required
starts_at
string<date-time>
required
title
string
required
Minimum string length: 1
deadline_timezone
string
Minimum string length: 1
description
string
goal_target
integer
Required range: x >= 1
goal_type
enum<string>
Available options:
posts,
comments,
cp,
streak,
missions,
custom
prize_description
string

Response

Created challenge

data
object
required