Emisión masiva

Emitir y enviar a escala de graduación o de día de inducción.

Hay tres maneras de hacerle algo a mucha gente, y no son intercambiables.

1. 1

   Primero, dar de alta a las personas

   PUT /v1/subjects es idempotente sobre externalId, así que volver a correr tu sincronización es seguro. Un grupo también se importa de una vez con POST /v1/groups/{id}/import.

2. 2

   Emitir

   Para credenciales de cartera, un POST /v1/credentials por persona con su Idempotency-Key. Para credenciales académicas, POST /v1/awards/bulk acepta hasta 500 destinatarios en una solicitud.

3. 3

   Enviar

   Una campaña encola los mensajes y los suelta a un ritmo, en vez de vaciar cuatrocientos correos de golpe.

curl -X POST https://api.nomi-tech.com/v1/awards/bulk \
  -H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
  -H "Content-Type: application/json" \
  -d '{
    "achievementKey": "leadership_2026",
    "recipients": [
      { "subjectId": "sub_…" },
      { "subjectId": "sub_…", "narrative": "Completed with distinction." }
    ]
  }'

Cada fila se intenta por su cuenta. A quien le falte un dato obligatorio falla esa fila y ninguna otra — una graduación no se detiene por el registro que nunca se llenó, y la respuesta dice exactamente cuáles hay que arreglar.

Actuar sobre muchas a la vez

POST /v1/credentials/bulk aplica suspend, resume, revoke o expire a una lista de identificadores y contesta cuántas se aplicaron y cuáles fallaron.