Create a tag
Creates a new SIM tag in the caller’s current organization. SIMs (devices) can optionally be linked to the tag at creation time via deviceids or bulk-selection parameters. Bulk selection requires the bulk_tag feature flag on the organization.
Authorizations
HTTP Basic authentication using API keys. Set the username to apikey and the password to your API key. You can find your API key on the Hologram Dashboard under Account Settings.
Body
Top-level parameters for bulk device selection via BulkSelection. Explicit deviceids are merged with filter-based selection. Some endpoints require a feature flag (e.g. bulk_rename, bulk_tag) before bulk selection is enabled.
Name for the new tag
Explicit list of device IDs to include in the selection.
When true, select all devices in the organization (subject to excludedDeviceIds).
When true, resolve the device selection from the search index using deviceFilters instead of the database.
Filter criteria for bulk device selection via BulkSelection. When resolved from the database (default), accepts the same filter fields as GET /devices (e.g. states, tagids, planid). When useSearch is true, also accepts search-index filter fields (e.g. links_cur_billing_data_used).
Device IDs to exclude from the bulk selection.
Top-level page numbers selected; presence triggers bulk device selection.