Skip to main content

Add a new ID tag

POST 
/id-tags/

Registers a new ID tag (RFID card, mobile credential, etc.) for charging authorization in the system.

Use Cases:

  • Provision new RFID cards for fleet drivers
  • Register mobile app authentication tokens
  • Pre-create tags for pending user assignments
  • Bulk import authorization credentials
  • Set up guest or temporary access credentials

Best Practices:

  • Use meaningful name values for easier identification in logs
  • Set expiryDate for temporary or time-limited credentials
  • Leave userId empty to create tags in PENDING status for later assignment
  • Ensure tagValue matches the physical RFID card or credential format
tip

Create tags with status=PENDING (or omit userId) for bulk provisioning scenarios where physical cards are distributed before user assignment.

warning

The tagValue must be unique across your tenant. Attempting to create a duplicate will result in a 400 error. Use GET /id-tags?tagValue=X to check for existence first.

note

Tags created with status=ACTIVE and a valid userId can immediately be used for charging authorization via OCPP.

Request​

Responses​

An ID tag used for charging authentication