[beta] Adds items to a campaign.

Adds assets to a campaign by VIN or asset ID, for campaigns whose membership is managed outside Samsara. Up to 5000 entries per request; the rate limit applies to this endpoint, not to the individual entries. Each entry is processed independently and the response reports a result per entry, in request order: created, alreadyPresent, unresolvedVin, unresolvedAssetId, invalid or overCap. A campaign holds at most 100000 items. Items are created in pending with sourceBasis api. An asset joins a campaign at most once, so requests are idempotent: an asset that already has an item, including a dismissed one, is reported as alreadyPresent and never re-added. Ingesting items never creates work orders or places holds. Not accepted for complete or cancelled campaigns.

Rate limit: 100 requests/min (learn more about rate limits here).

To use this endpoint, select Write Campaigns under the Work Orders category when creating or editing an API token. Learn More.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Unique ID of the campaign.

Body Params

Entries to ingest.

data
array of objects
required
length between 1 and 5000

Entries to add to the campaign.

data*
Responses

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json