Skip to main content

Activate a pending ID tag

POST 
/id-tags/:id/activate

Transitions a pending ID tag to active status, optionally setting a name and metadata without requiring user assignment.

Use Cases:

  • Activate organization-level shared tags (fleet vehicles, guest access)
  • Enable tags for anonymous/public charging access
  • Complete onboarding for tags not tied to specific users
  • Bulk activate provisioned tags after approval
  • Set descriptive names during activation workflow

What Happens:

  1. Tag status changes from PENDING to ACTIVE
  2. Optional name is set if provided
  3. Optional metadata is stored if provided
  4. userId remains null (tag not assigned to specific user)
  5. Tag can now authorize charging sessions via OCPP

Important Notes:

  • Tag must currently be in PENDING status
  • userId is NOT set by this endpoint (use PATCH /id-tags/:id for user assignment)
  • Activated tags work for organization-level or anonymous charging
  • Use this for shared fleet tags or public charging access

Alternative Approaches:

  • User Assignment: Use PATCH /id-tags/:id with userId + status=ACTIVE
  • Status Only: Use PUT /id-tags/:id/status with status=ACTIVE
info

This endpoint activates tags WITHOUT assigning them to users. Use for shared fleet tags, guest access, or public charging scenarios.

tip

To activate AND assign to a user simultaneously, use PATCH /id-tags/:id with both userId and status=ACTIVE fields.

note

The tag must be in PENDING status. Attempting to activate an already ACTIVE or BLOCKED tag will result in an error.

Request​

Responses​

An ID tag used for charging authentication