Create entity

Creates a new Entities of the specified type. You must specify the type (e.g. feature, initiative) and provide required fields based on your workspace configuration.

Use the /configuration endpoint to discover what fields are available and required.

Limitations

• The field names and availability depend on your workspace setup.

Code examples

Replace <your-token> with a valid API token. Replace <parent-id> with the ID of the parent entity (if required by the entity type).

Create a new feature with name, status, and parent:

curl -X POST "https://api.productboard.com/v2/entities" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "feature",
      "fields": {
        "name": "New login flow",
        "status": { "name": "Planned" }
      },
      "relationships": [
        {
          "type": "parent",
          "target": { "id": "<parent-id>" }
        }
      ]
    }
  }'

Create a new product with only a name:

curl -X POST "https://api.productboard.com/v2/entities" \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "product",
      "fields": {
        "name": "Komio Platform"
      }
    }
  }'