curl --request POST \
--url https://api.us.cr4ce.com/field \
--header 'Accept: <accept>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"type": "text",
"resource": "entries",
"tab": "AbCdEfGh",
"form": "PqRsTuVw",
"protection": "standard",
"translated": {
"title": {
"en_GB": "Project summary"
},
"help_text": {
"en_GB": "Describe the project in a few sentences."
}
}
}
'{
"entrant_read_access": true,
"entrant_write_access": true,
"auto_scoring": 0,
"categories": [
"*"
],
"category_count": "all",
"conditional_field": null,
"created": "2025-01-15T09:00:00Z",
"file_types": [],
"form": {
"slug": "GhIjKlMn",
"link": "https://api.au.cr4ce.com/form/GhIjKlMn",
"name": {
"en_GB": "Entry form"
}
},
"help_text": {
"en_GB": "<p>Provide a concise summary of your work.</p>"
},
"hint_text": {
"en_GB": "<p>Up to 500 words.</p>"
},
"label": {
"en_GB": "<p>Summary</p>"
},
"max_file_size": null,
"maximum_characters": null,
"maximum_words": 500,
"minimum_characters": null,
"minimum_words": null,
"options": [],
"order": 1,
"protection": "standard",
"registration": null,
"required": true,
"resource": "entries",
"schema": null,
"searchable": true,
"season": {
"slug": "QrStUvWx",
"link": "https://api.au.cr4ce.com/season/QrStUvWx",
"name": {
"en_GB": "2025"
}
},
"slug": "AbCdEfGh",
"tab": {
"slug": "StUvWxYz",
"link": "https://api.au.cr4ce.com/tab/StUvWxYz",
"name": {
"en_GB": "About you"
}
},
"title": {
"en_GB": "Summary"
},
"type": "textarea",
"updated": "2025-06-20T14:30:00Z",
"visibility": [
"qualifying",
"vip_judging"
]
}{
"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"
}Create field
Create a field.
curl --request POST \
--url https://api.us.cr4ce.com/field \
--header 'Accept: <accept>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"type": "text",
"resource": "entries",
"tab": "AbCdEfGh",
"form": "PqRsTuVw",
"protection": "standard",
"translated": {
"title": {
"en_GB": "Project summary"
},
"help_text": {
"en_GB": "Describe the project in a few sentences."
}
}
}
'{
"entrant_read_access": true,
"entrant_write_access": true,
"auto_scoring": 0,
"categories": [
"*"
],
"category_count": "all",
"conditional_field": null,
"created": "2025-01-15T09:00:00Z",
"file_types": [],
"form": {
"slug": "GhIjKlMn",
"link": "https://api.au.cr4ce.com/form/GhIjKlMn",
"name": {
"en_GB": "Entry form"
}
},
"help_text": {
"en_GB": "<p>Provide a concise summary of your work.</p>"
},
"hint_text": {
"en_GB": "<p>Up to 500 words.</p>"
},
"label": {
"en_GB": "<p>Summary</p>"
},
"max_file_size": null,
"maximum_characters": null,
"maximum_words": 500,
"minimum_characters": null,
"minimum_words": null,
"options": [],
"order": 1,
"protection": "standard",
"registration": null,
"required": true,
"resource": "entries",
"schema": null,
"searchable": true,
"season": {
"slug": "QrStUvWx",
"link": "https://api.au.cr4ce.com/season/QrStUvWx",
"name": {
"en_GB": "2025"
}
},
"slug": "AbCdEfGh",
"tab": {
"slug": "StUvWxYz",
"link": "https://api.au.cr4ce.com/tab/StUvWxYz",
"name": {
"en_GB": "About you"
}
},
"title": {
"en_GB": "Summary"
},
"type": "textarea",
"updated": "2025-06-20T14:30:00Z",
"visibility": [
"qualifying",
"vip_judging"
]
}{
"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"
}formula or ai field types through the API.file and table cannot be used when resource is attachments, contributors, or referees. lookup is available only on grant report forms. A type that is not available for the chosen resource returns 422 Unprocessable Entity.Authorizations
API key used to authenticate and authorise every request.
Include it in the x-api-key header.
Headers
Defines the response type.
application/vnd.Creative Force.v2.3+json, application/vnd.Creative Force.v2.3+xml 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.
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
Field creation payload.
Type of the field.
checkbox, checkboxlist, content, country, currency, date, datetime, drop-down-list, email, file, lookup, numeric, phone, radio, table, text, textarea, time, url Translated field values keyed by field name.
Show child attributes
Show child attributes
Resource the field collects data for.
Defaults to entries when you omit it. Send the value in lower case, exactly as GET field/{fieldSlug} returns it.
entries, users, attachments, contributors, referees, organisations Slug of the tab the field belongs to.
Required when resource is entries, attachments, or contributors. Not used when resource is users or referees.
^[A-Za-z]{8}$Slug of the form the field belongs to.
Required when resource is attachments, contributors, or referees. Optional when resource is entries, where the default form for the active season applies if you omit it. Ignored when resource is users, because user fields are not attached to a form.
The form must be valid for the active season and the field type.
^[A-Za-z]{8}$Protection level governing access to the data for the field.
Defaults to elevated when resource is users, and standard otherwise. Fields of type file are always standard.
standard, elevated, maximum Currency code.
Required when type is currency.
Response
Field created.
Whether entrants can view this field.
Whether entrants can edit this field.
Score awarded automatically for the field, or 0 when automatic judging is not configured.
Category slugs the field is associated with, or ["*"] for every category.
Number of categories the field is associated with, all when it applies to every category, or null when not category-scoped.
Field whose value controls whether this field is shown, or null when the field is not conditional.
Show child attributes
Show child attributes
Date and time when the field was created.
Permitted file extensions for file fields, empty when no restriction applies.
Form the field belongs to, or null when the field is not attached to a form.
Show child attributes
Show child attributes
Help text shown for the field, as an HTML fragment keyed by locale code.
Show child attributes
Show child attributes
Hint text shown for the field, as an HTML fragment keyed by locale code.
Show child attributes
Show child attributes
Label of the field, as an HTML fragment keyed by locale code.
Show child attributes
Show child attributes
Maximum upload size in megabytes for file fields, or null when no limit applies.
Maximum number of characters accepted, or null when no limit applies.
Maximum number of words accepted, or null when no limit applies.
Minimum number of characters required, or null when no limit applies.
Minimum number of words required, or null when no limit applies.
Selectable options for choice fields (for example, drop-down or radio). Empty when the field type has no options.
Position of the field within its tab.
Protection level governing access to the data for the field (for example, standard, elevated, or maximum).
Registration attribute the field is mapped to, or null if unmapped.
Whether a value is required for the field.
Resource the field collects data for (for example, the entry or application, contributors, referees, attachments, or users).
Column structure of a table field, or null for every other field type.
Show child attributes
Show child attributes
Whether the field is included in search.
Season the field belongs to.
Show child attributes
Show child attributes
Short URL-safe identifier for the field.
Tab the field belongs to, or null when the field is not attached to a tab.
Show child attributes
Show child attributes
Plain-text title of the field, keyed by locale code.
Show child attributes
Show child attributes
Field type (for example, text, textarea, drop-down-list, file, currency, or date).
Date and time when the field was last updated.
Contexts in which the field is visible (for example, qualifying, top_pick, voting, gallery, or vip_judging).