Create bulk operation | Documentation

curl -X POST "https://api.contentful.com/spaces/<space_id>/environments/<environment_id>/bulk_operations/entries/create" \
  -H "Authorization: Bearer <cma_token>" \
  -H "Content-Type: application/vnd.contentful.management.v1+json" \
  -d '{"upload":{"sys":{"type":"Upload","id":"<upload_id>"}}}'

{
  "sys": {
    "id": "bulkOperationId123",
    "type": "BulkContentOperation",
    "bulkType": "EntriesCreate",
    "status": "in_progress",
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "ncbxgqx5v0xe"
      }
    },
    "environment": {
      "sys": {
        "type": "Link",
        "linkType": "Environment",
        "id": "master"
      }
    },
    "createdBy": {
      "sys": {
        "type": "Link",
        "linkType": "User",
        "id": "6Ynia2PFrjsO15piM8eljZ"
      }
    },
    "createdAt": "2025-11-27T13:50:00.000Z",
    "updatedAt": "2025-11-27T13:50:00.000Z"
  },
  "payload": {
    "upload": {
      "sys": {
        "type": "Upload",
        "id": "6gbwC4qRtakgsdqUcCPihF"
      }
    }
  }
}

Creates a bulk operation from a previous upload, processing entries asynchronously. Omit sys.id for auto-generated IDs; existing IDs will fail with EntryExistsError.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

Alphanumeric id of the space.

environment_idstringRequired

Alphanumeric id of the environment. Defaults to master.

Request

This endpoint expects a map from strings to any.

Response

Created - Bulk operation created successfully

Errors

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error