[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.
<b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).
To use this endpoint, select Write Campaigns under the Work Orders category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.
Request
- Base URLhttps://api.samsara.com
- AuthHTTP bearer
Query parameters
Unique ID of the campaign.
Request body
Example request
{
"data": [
{
"assetId": "281474976710655",
"sourceRef": "recall-feed-2026-02-01:row-1042",
"vin": "1FUJGHDV0CLBP8834"
}
]
}Response
OK response.
Example response
{
"requestId": "1f7f5081-9f8e-4b68-8b85-97dbe4b46d7e",
"responses": [
{
"assetId": "281474976710655",
"message": "No asset in your organization has this VIN.",
"result": "created",
"status": 200
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.