Projects

Create a new project

Creates a new project for organizing and tracking content across different platforms and accounts.

post/projects

Request

  • Base URL: https://viral.app/api/v1
  • URL: https://viral.app/api/v1/projects
  • Auth: API key in header x-api-key

Request body

namestring required

Project name

descriptionstring

Project description

logostring

Project logo

appleAppIdstring nullable

Apple app ID

visibleToCreatorsboolean

Whether creators see this tag's name where it decides their pay (campaign payout conditions). When false, creators see “videos the brand selects” instead. Country and continent tags are always visible.

Example request

{
  "name": "Holiday Campaign 2024",
  "url": "https://www.example.com/holiday-campaign",
  "description": "Winter holiday marketing campaign across all social platforms",
  "logo": "https://www.example.com/images/holiday-logo.png",
  "appleAppId": "orgaplapp_R4W8KPM5YTB9"
}

Response

OK

idstring required
namestring required
urlstring nullable required
descriptionstring nullable required
logostring nullable required
appleAppIdstring nullable required
visibleToCreatorsboolean required
createdAtstring date-time required
updatedAtstring date-time required
actorType'user' | 'system' | 'api_token' required
userIdstring required
orgIdstring required

Example response

{
  "id": "orgproj_RwmraAffhMt9",
  "name": "Holiday Campaign 2024",
  "url": "https://www.example.com/holiday-campaign",
  "description": "Winter holiday marketing campaign across all social platforms",
  "logo": "https://www.example.com/images/holiday-logo.png",
  "appleAppId": "orgaplapp_R4W8KPM5YTB9",
  "visibleToCreators": true,
  "createdAt": "2025-01-15T10:00:00.000Z",
  "updatedAt": "2025-01-15T10:00:00.000Z",
  "userId": "user_PxyfnFj5JUx5",
  "orgId": "org_GbuDqv3RjdSW"
}

Changes

No recorded changes to this operation across all 1 revision of this API.