Skip to content

Create an entry

POST
/channels/{channel_id}/entries

Creates a channel entry. Non-master tokens must pass channel create ACL checks. Master tokens bypass ACL unless use_acl=true and can set _acl and _owner in the payload.

Authorizations

bearerToken|siteContext
bearerToken

Personal access token tied to a user account. Requires the X-Nimbu-Site header to scope requests.

TypeHTTP (bearer)
+
siteContext

Identifier of the site context when authenticating with a personal access token.

TypeAPI Key (header: X-Nimbu-Site)
or
siteToken

Site-scoped API token that already encodes the site context.

TypeHTTP (bearer)

Parameters

Header Parameters

Session-Token

Customer session token used for channel create ACL checks. X-Nimbu-Session-Token is also accepted.

Typestring

Path Parameters

channel_id*

Channel identifier

Typestring
Required

Query Parameters

use_acl

When true, applies customer ACL filtering to master-token requests.

Typeboolean

Request Body

application/json
JSON
{
"_acl": {
"additionalProperties": {
}
},
"_owner": "string",
"additionalProperties": "string"
}

Responses

entry created

application/json
JSON
{
"id": "string",
"url": "string",
"short_id": "string",
"slug": "string",
"channel": "string",
"created_at": "string",
"updated_at": "string",
"title_field_value": "string",
"_acl": {
"additionalProperties": {
}
},
"_owner": "string",
"additionalProperties": "string"
}

Playground

Authorization
Headers
Variables
Key
Value
Body

Samples

Part of Nimbu, built by Zenjoy.