Create Document

Add a new document to a specified collection.

POST /api/datastores/v2/collections/{collectionId}/documents

cURL

campaign

curl --request POST \
  --url https://{instance}.domo.com/api/datastores/v2/collections/{collectionId}/documents \
  --header 'Content-Type: application/json' \
  --header 'X-DOMO-Developer-Token: <api-key>' \
  --data '
{
  "content": {
    "campaignName": "Q2 Campaign",
    "region": "West",
    "status": "Active"
  }
}
'

200

{
  "id": "a8428d64-a01d-49b2-9144-ddeec001acf8",
  "datastoreId": "39b88a97-8247-4c0d-ba1d-8ed78d1a6680",
  "collectionId": "232e6d6c-46e9-49b6-a137-8933f0f05999",
  "syncRequired": true,
  "owner": "870010733",
  "createdBy": "870010733",
  "createdOn": "2026-06-23T20:58:06.567Z",
  "updatedOn": "2026-06-23T23:36:13.177Z",
  "updatedBy": "870010733",
  "content": {
    "campaignName": "Q2 Campaign",
    "region": "West",
    "status": "Active"
  }
}

Authorizations

X-DOMO-Developer-Token · string · header · required

Domo Developer Token for authentication.

Path Parameters

collectionId · string · required

The ID of the collection.

Body

application/json

content · object

Arbitrary JSON content of the document. If omitted, the document is created with an empty content object.

Response

200

application/json

OK

id · string

Unique identifier for the document.

datastoreId · string

ID of the datastore the document belongs to.

collectionId · string

ID of the collection the document belongs to.

syncRequired · boolean

Whether the document is pending a sync to the underlying dataset.

owner · string

User ID of the document owner. v2 endpoints return this as a string; v1 endpoints (List, Get, Query, Update) return it as a numeric integer. This differs from Collection and Datastore owner fields, which are always integers.

createdBy · string

User ID of the user who created the document. v2 endpoints always return this field. v1 endpoints return it only from Create Document; all other v1 endpoints (List, Get, Query, Update) omit it.

createdOn · string<date-time>

ISO 8601 timestamp when the document was created.

updatedOn · string<date-time>

ISO 8601 timestamp when the document was last updated.

updatedBy · string

User ID of the user who last updated the document. v2 endpoints return this as a string; v1 endpoints return it as a numeric integer.

content · object

Arbitrary JSON content of the document.