Create category

curl --request POST \
  --url https://api.us.cr4ce.com/category \
  --header 'Accept: <accept>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "season": "<string>",
  "translated": {
    "name": {},
    "description": {},
    "entry_name_label": {},
    "image_heading": {},
    "packing_slip_instructions": {},
    "shortcode": {}
  },
  "chapters": [
    "<string>"
  ],
  "divisions": 2,
  "entrant_max_entries": 2,
  "fill_entry_name": true,
  "max_image_width": 123,
  "form": "<string>",
  "parent": "<string>",
  "pdf_packing_slip": true
}
'

import requests

url = "https://api.us.cr4ce.com/category"

payload = {
    "season": "<string>",
    "translated": {
        "name": {},
        "description": {},
        "entry_name_label": {},
        "image_heading": {},
        "packing_slip_instructions": {},
        "shortcode": {}
    },
    "chapters": ["<string>"],
    "divisions": 2,
    "entrant_max_entries": 2,
    "fill_entry_name": True,
    "max_image_width": 123,
    "form": "<string>",
    "parent": "<string>",
    "pdf_packing_slip": True
}
headers = {
    "Accept": "<accept>",
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Accept: '<accept>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    season: '<string>',
    translated: {
      name: {},
      description: {},
      entry_name_label: {},
      image_heading: {},
      packing_slip_instructions: {},
      shortcode: {}
    },
    chapters: ['<string>'],
    divisions: 2,
    entrant_max_entries: 2,
    fill_entry_name: true,
    max_image_width: 123,
    form: '<string>',
    parent: '<string>',
    pdf_packing_slip: true
  })
};

fetch('https://api.us.cr4ce.com/category', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.us.cr4ce.com/category",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'season' => '<string>',
    'translated' => [
        'name' => [
                
        ],
        'description' => [
                
        ],
        'entry_name_label' => [
                
        ],
        'image_heading' => [
                
        ],
        'packing_slip_instructions' => [
                
        ],
        'shortcode' => [
                
        ]
    ],
    'chapters' => [
        '<string>'
    ],
    'divisions' => 2,
    'entrant_max_entries' => 2,
    'fill_entry_name' => true,
    'max_image_width' => 123,
    'form' => '<string>',
    'parent' => '<string>',
    'pdf_packing_slip' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Accept: <accept>",
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.us.cr4ce.com/category"

	payload := strings.NewReader("{\n  \"season\": \"<string>\",\n  \"translated\": {\n    \"name\": {},\n    \"description\": {},\n    \"entry_name_label\": {},\n    \"image_heading\": {},\n    \"packing_slip_instructions\": {},\n    \"shortcode\": {}\n  },\n  \"chapters\": [\n    \"<string>\"\n  ],\n  \"divisions\": 2,\n  \"entrant_max_entries\": 2,\n  \"fill_entry_name\": true,\n  \"max_image_width\": 123,\n  \"form\": \"<string>\",\n  \"parent\": \"<string>\",\n  \"pdf_packing_slip\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Accept", "<accept>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.us.cr4ce.com/category")
  .header("Accept", "<accept>")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"season\": \"<string>\",\n  \"translated\": {\n    \"name\": {},\n    \"description\": {},\n    \"entry_name_label\": {},\n    \"image_heading\": {},\n    \"packing_slip_instructions\": {},\n    \"shortcode\": {}\n  },\n  \"chapters\": [\n    \"<string>\"\n  ],\n  \"divisions\": 2,\n  \"entrant_max_entries\": 2,\n  \"fill_entry_name\": true,\n  \"max_image_width\": 123,\n  \"form\": \"<string>\",\n  \"parent\": \"<string>\",\n  \"pdf_packing_slip\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.us.cr4ce.com/category")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Accept"] = '<accept>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"season\": \"<string>\",\n  \"translated\": {\n    \"name\": {},\n    \"description\": {},\n    \"entry_name_label\": {},\n    \"image_heading\": {},\n    \"packing_slip_instructions\": {},\n    \"shortcode\": {}\n  },\n  \"chapters\": [\n    \"<string>\"\n  ],\n  \"divisions\": 2,\n  \"entrant_max_entries\": 2,\n  \"fill_entry_name\": true,\n  \"max_image_width\": 123,\n  \"form\": \"<string>\",\n  \"parent\": \"<string>\",\n  \"pdf_packing_slip\": true\n}"

response = http.request(request)
puts response.read_body

{
  "created": "2025-01-15T09:00:00Z",
  "description": {
    "en_GB": "Submit your documentary films exploring real-world subjects and stories."
  },
  "divisions": 1,
  "form": {
    "slug": "GhIjKlMn",
    "link": "https://api.au.cr4ce.com/form/GhIjKlMn",
    "name": {
      "en_GB": "Entry form"
    }
  },
  "name": {
    "en_GB": "Documentary"
  },
  "parent": {
    "slug": "KlMnOpQr",
    "link": "https://api.au.cr4ce.com/category/KlMnOpQr",
    "name": {
      "en_GB": "Film"
    }
  },
  "promoted": null,
  "season": {
    "slug": "QrStUvWx",
    "link": "https://api.au.cr4ce.com/season/QrStUvWx",
    "name": {
      "en_GB": "2025"
    }
  },
  "shortcode": {
    "en_GB": "01"
  },
  "slug": "AbCdEfGh",
  "status": "active",
  "updated": "2025-06-20T14:30:00Z",
  "chapters": [
    {
      "slug": "MnOpQrSt",
      "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
      "name": {
        "en_GB": "Film"
      }
    }
  ],
  "entrant_max_entries": null,
  "entry_name_label": {
    "en_GB": "Entry title"
  },
  "fill_entry_name": false,
  "image_heading": {
    "en_GB": "Category image"
  },
  "images": [
    {
      "token": "AbCdEfGhIjKlMnOp",
      "link": "https://api.au.cr4ce.com/file/AbCdEfGhIjKlMnOp",
      "filename": "example.png",
      "download": "https://files.au.cr4ce.com/file/AbCdEfGhIjKlMnOp/example.png?Expires=1781657570&Signature=REDACTED&Key-Pair-Id=REDACTED"
    }
  ],
  "max_image_width": 300,
  "packing_slip_instructions": {
    "en_GB": "Attach this slip to each physical submission."
  },
  "pdf_packing_slip": false
}

{
  "message": "<string>",
  "status_code": 400
}

{
  "message": "<string>",
  "status_code": 401
}

{
  "message": "<string>",
  "status_code": 403
}

{
  "message": "<string>",
  "status_code": 422,
  "errors": {}
}

{
  "message": "<string>",
  "status_code": 429
}

{
  "status": "Maintenance in progress"
}

POST

category

Create category

curl --request POST \
  --url https://api.us.cr4ce.com/category \
  --header 'Accept: <accept>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "season": "<string>",
  "translated": {
    "name": {},
    "description": {},
    "entry_name_label": {},
    "image_heading": {},
    "packing_slip_instructions": {},
    "shortcode": {}
  },
  "chapters": [
    "<string>"
  ],
  "divisions": 2,
  "entrant_max_entries": 2,
  "fill_entry_name": true,
  "max_image_width": 123,
  "form": "<string>",
  "parent": "<string>",
  "pdf_packing_slip": true
}
'

import requests

url = "https://api.us.cr4ce.com/category"

payload = {
    "season": "<string>",
    "translated": {
        "name": {},
        "description": {},
        "entry_name_label": {},
        "image_heading": {},
        "packing_slip_instructions": {},
        "shortcode": {}
    },
    "chapters": ["<string>"],
    "divisions": 2,
    "entrant_max_entries": 2,
    "fill_entry_name": True,
    "max_image_width": 123,
    "form": "<string>",
    "parent": "<string>",
    "pdf_packing_slip": True
}
headers = {
    "Accept": "<accept>",
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    Accept: '<accept>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    season: '<string>',
    translated: {
      name: {},
      description: {},
      entry_name_label: {},
      image_heading: {},
      packing_slip_instructions: {},
      shortcode: {}
    },
    chapters: ['<string>'],
    divisions: 2,
    entrant_max_entries: 2,
    fill_entry_name: true,
    max_image_width: 123,
    form: '<string>',
    parent: '<string>',
    pdf_packing_slip: true
  })
};

fetch('https://api.us.cr4ce.com/category', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.us.cr4ce.com/category",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'season' => '<string>',
    'translated' => [
        'name' => [
                
        ],
        'description' => [
                
        ],
        'entry_name_label' => [
                
        ],
        'image_heading' => [
                
        ],
        'packing_slip_instructions' => [
                
        ],
        'shortcode' => [
                
        ]
    ],
    'chapters' => [
        '<string>'
    ],
    'divisions' => 2,
    'entrant_max_entries' => 2,
    'fill_entry_name' => true,
    'max_image_width' => 123,
    'form' => '<string>',
    'parent' => '<string>',
    'pdf_packing_slip' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Accept: <accept>",
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.us.cr4ce.com/category"

	payload := strings.NewReader("{\n  \"season\": \"<string>\",\n  \"translated\": {\n    \"name\": {},\n    \"description\": {},\n    \"entry_name_label\": {},\n    \"image_heading\": {},\n    \"packing_slip_instructions\": {},\n    \"shortcode\": {}\n  },\n  \"chapters\": [\n    \"<string>\"\n  ],\n  \"divisions\": 2,\n  \"entrant_max_entries\": 2,\n  \"fill_entry_name\": true,\n  \"max_image_width\": 123,\n  \"form\": \"<string>\",\n  \"parent\": \"<string>\",\n  \"pdf_packing_slip\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Accept", "<accept>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.us.cr4ce.com/category")
  .header("Accept", "<accept>")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"season\": \"<string>\",\n  \"translated\": {\n    \"name\": {},\n    \"description\": {},\n    \"entry_name_label\": {},\n    \"image_heading\": {},\n    \"packing_slip_instructions\": {},\n    \"shortcode\": {}\n  },\n  \"chapters\": [\n    \"<string>\"\n  ],\n  \"divisions\": 2,\n  \"entrant_max_entries\": 2,\n  \"fill_entry_name\": true,\n  \"max_image_width\": 123,\n  \"form\": \"<string>\",\n  \"parent\": \"<string>\",\n  \"pdf_packing_slip\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.us.cr4ce.com/category")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Accept"] = '<accept>'
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"season\": \"<string>\",\n  \"translated\": {\n    \"name\": {},\n    \"description\": {},\n    \"entry_name_label\": {},\n    \"image_heading\": {},\n    \"packing_slip_instructions\": {},\n    \"shortcode\": {}\n  },\n  \"chapters\": [\n    \"<string>\"\n  ],\n  \"divisions\": 2,\n  \"entrant_max_entries\": 2,\n  \"fill_entry_name\": true,\n  \"max_image_width\": 123,\n  \"form\": \"<string>\",\n  \"parent\": \"<string>\",\n  \"pdf_packing_slip\": true\n}"

response = http.request(request)
puts response.read_body

{
  "created": "2025-01-15T09:00:00Z",
  "description": {
    "en_GB": "Submit your documentary films exploring real-world subjects and stories."
  },
  "divisions": 1,
  "form": {
    "slug": "GhIjKlMn",
    "link": "https://api.au.cr4ce.com/form/GhIjKlMn",
    "name": {
      "en_GB": "Entry form"
    }
  },
  "name": {
    "en_GB": "Documentary"
  },
  "parent": {
    "slug": "KlMnOpQr",
    "link": "https://api.au.cr4ce.com/category/KlMnOpQr",
    "name": {
      "en_GB": "Film"
    }
  },
  "promoted": null,
  "season": {
    "slug": "QrStUvWx",
    "link": "https://api.au.cr4ce.com/season/QrStUvWx",
    "name": {
      "en_GB": "2025"
    }
  },
  "shortcode": {
    "en_GB": "01"
  },
  "slug": "AbCdEfGh",
  "status": "active",
  "updated": "2025-06-20T14:30:00Z",
  "chapters": [
    {
      "slug": "MnOpQrSt",
      "link": "https://api.au.cr4ce.com/chapter/MnOpQrSt",
      "name": {
        "en_GB": "Film"
      }
    }
  ],
  "entrant_max_entries": null,
  "entry_name_label": {
    "en_GB": "Entry title"
  },
  "fill_entry_name": false,
  "image_heading": {
    "en_GB": "Category image"
  },
  "images": [
    {
      "token": "AbCdEfGhIjKlMnOp",
      "link": "https://api.au.cr4ce.com/file/AbCdEfGhIjKlMnOp",
      "filename": "example.png",
      "download": "https://files.au.cr4ce.com/file/AbCdEfGhIjKlMnOp/example.png?Expires=1781657570&Signature=REDACTED&Key-Pair-Id=REDACTED"
    }
  ],
  "max_image_width": 300,
  "packing_slip_instructions": {
    "en_GB": "Attach this slip to each physical submission."
  },
  "pdf_packing_slip": false
}

{
  "message": "<string>",
  "status_code": 400
}

{
  "message": "<string>",
  "status_code": 401
}

{
  "message": "<string>",
  "status_code": 403
}

{
  "message": "<string>",
  "status_code": 422,
  "errors": {}
}

{
  "message": "<string>",
  "status_code": 429
}

{
  "status": "Maintenance in progress"
}

Authorizations

x-api-key

string

header

required

API key used to authenticate and authorise every request. Include it in the x-api-key header.

Headers

enum<string>

required

Defines the response type.

Available options:

application/vnd.Creative Force.v2.3+json,

application/vnd.Creative Force.v2.3+xml

x-api-language

enum<string>[]

Defines the languages included in the response. If non are provided, the account default language is returned.

Value all overrides any other values present.

You can request multiple languages using a comma-separated string of languages.

The selected language must be supported by your account or a 400 error is returned.

Available options:

all,

ar_AR,

bg_BG,

bn_IN,

ca_ES,

cs_CZ,

cy_GB,

da_DK,

de_DE,

en_GB,

en_US,

el_GR,

es_NN,

es_LA,

et_EE,

fa_NN,

fi_FI,

fr_FR,

fr_CA,

he_IL,

hi_IN,

hr_HR,

hu_HU,

hy_AM,

it_IT,

ja_JP,

ko_KR,

lt_LT,

ms_MY,

nl_NL,

nb_NO,

pl_PL,

pt_BR,

ro_RO,

ru_RU,

sk_SK,

sl_SI,

sq_AL,

sr_RS,

sv_SE,

sw_NN,

th_TH,

tr_TR,

uk_UA,

vi_VN,

zh_CN,

zh_HK

Body

application/json

Category creation payload.

season

string

required

Slug of the season.

status

enum<string>

required

Active or inactive state of the category.

Available options:

active,

inactive

translated

object

required

Translated category field values keyed by field name.

Show child attributes

chapters

string[]

Array of chapter slugs.

Each chapter must belong to the same season as season.

divisions

integer

Number of divisions.

Required range: x >= 1

entrant_max_entries

integer | null

Maximum number of entries per entrant.

Required range: x >= 1

fill_entry_name

boolean

Specifies whether to prefill the entry name when the category is selected.

max_image_width

integer

Maximum image width.

form

string

Slug of the form.

The form must be valid for season.

parent

string

Slug of the parent category.

The parent category must belong to the same season as season.

promoted

enum<integer> | null

Promotion state of the category.

1 when promoted, 0 when not, and null when no preference has been set.

Available options:

0,

1,

null

pdf_packing_slip

boolean

Specifies whether to generate a PDF packing slip.

Required when translated.packing_slip_instructions is provided.

Response

Category created.

Competition category that entries are submitted to.

created

string<date-time>

Date and time when the category was created.

description

object

Description shown to entrants on the category, as an HTML fragment map keyed by locale code.

Show child attributes

divisions

integer

Number of divisions configured for the category, always at least 1.

Required range: x >= 1

form

object

Entry form attached to the category.

Show child attributes

name

object

Display name of the category, as a map of translated strings keyed by locale code.

Show child attributes

parent

object | null

Parent category this category sits under, or null for a top-level category.

Show child attributes

promoted

enum<integer> | null

Promotion state of the category, 1 when promoted, 0 when not, and null when unset.

Available options:

0,

1,

null

season

object

Season the category belongs to.

Show child attributes

shortcode

object

Short code used to reference the category, as a map of translated strings keyed by locale code.

Show child attributes

slug

string

Short URL-safe identifier for the category.

status

enum<string>

Current state of the category.

Available options:

active,

inactive

updated

string<date-time>

Date and time when the category was last updated.

chapters

object[]

Chapters the category is available in.

Show child attributes

entrant_max_entries

integer | null

Maximum number of entries a single entrant may submit to this category, or null if uncapped.

entry_name_label

object

Custom label for the entry-name field shown to entrants, as a map of translated strings keyed by locale code.

Show child attributes

fill_entry_name

boolean

Specifies whether entrants are asked to name their entry when submitting to this category.

image_heading

object

Heading shown above the category images, as a map of translated strings keyed by locale code.

Show child attributes

images

object[]

Images attached to the category.

Show child attributes

max_image_width

integer

Maximum display width for the category images, in pixels.

packing_slip_instructions

object

Instructions shown on the packing slip for the category, as a map of translated strings keyed by locale code.

Show child attributes

pdf_packing_slip

boolean

Specifies whether a PDF packing slip is enabled for the category.