Beta APIs

[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.

post/maintenance/campaigns/items/batch

Request

  • Base URL
    https://api.samsara.com
  • Auth
    HTTP bearer

Query parameters

campaignIdstring required

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.

requestIdstring uuid required

UUID for this batch request; used when reaching out to support.

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.