Notificaciones

47 operaciones, cada una con sus parámetros, ejemplos en curl y TypeScript listos para copiar y sus errores.

Las operaciones marcadas /v1 se autentican con un token de agente; las demás, con una sesión del panel. Cómo funcionan ambas está en Autenticación

`approvalSettings`

GET/_x/query/approval-settings

Miembro de la firmaPermiso: notification:readHerramienta MCP: approvalSettings

Always required: sendNotification by anyone who cannot send (a paralegal, an unverified lawyer) files a request (awaiting_approval) a verified lawyer decides. noDecider: nobody but you could decide yours. Read-only.

Parámetros de approvalSettings
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/approval-settings?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/approval-settings?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`bounceAlerts`

GET/v1/bounce-alerts

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: bounceAlerts

Recipients bounced, failed or complained and not re-issued yet; the lawyer re-issues in the panel.

Parámetros de bounceAlerts
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–200`page size; present, the response is the page envelope rather than the bare rows (1 to 200)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/bounce-alerts?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/bounce-alerts?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  {
    "at": "<at>",
    "caseId": "<caseId>",
    "email": "<email>",
    "id": "<id>",
    "name": "<name>",
    "notificationId": "<notificationId>",
    "radicado": "<radicado>",
    "recipientId": "<recipientId>",
    "status": "bounced",
    "switched": true
  }
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`caseCourtOutcomes`

GET/v1/case-court-outcomes

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: caseCourtOutcomes

The current court outcome per notification of a case.

Parámetros de caseCourtOutcomes
Nombre	Dónde	Tipo	Obligatorio
`caseId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/case-court-outcomes?caseId=<caseId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/case-court-outcomes?caseId=<caseId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`caseMemorials`

GET/v1/case-memorials

Miembro de la firmaPermiso: memorial:read/v1 · token BearerHerramienta MCP: caseMemorials

A case's memoriales with their hashes.

Parámetros de caseMemorials
Nombre	Dónde	Tipo	Obligatorio
`caseId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–200`page size; present, the response is the page envelope rather than the bare rows (1 to 200)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/case-memorials?caseId=<caseId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/case-memorials?caseId=<caseId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  {
    "caseId": "<caseId>",
    "createdAt": "<createdAt>",
    "docxBytes": 1,
    "docxSha256": "<docxSha256>",
    "id": "<id>",
    "keysetAt": "<keysetAt>",
    "notificationId": "<notificationId>",
    "orgId": "<orgId>",
    "pdfBytes": 1,
    "pdfSha256": "<pdfSha256>"
  }
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`caseNotifications`

GET/v1/case-notifications

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: caseNotifications

One case's notifications, newest first (up to 200), with their status and where the evidence stands.

Parámetros de caseNotifications
Nombre	Dónde	Tipo	Obligatorio
`caseId`	Consulta	`string (uuid)`	Sí
`limit`	Consulta	`integer 1–200`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/case-notifications?caseId=<caseId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/case-notifications?caseId=<caseId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`caseRecipients`

GET/v1/case-recipients

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: caseRecipients

Recipients of a case's notifications with delivery, acuse and surtida (UTC).

Parámetros de caseRecipients
Nombre	Dónde	Tipo	Obligatorio
`caseId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–1000`page size; present, the response is the page envelope rather than the bare rows (1 to 1000)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/case-recipients?caseId=<caseId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/case-recipients?caseId=<caseId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  {
    "acknowledgedAt": "<acknowledgedAt>",
    "caseId": "<caseId>",
    "conservativeSurtidaAt": "<conservativeSurtidaAt>",
    "createdAt": "<createdAt>",
    "email": "<email>",
    "id": "<id>",
    "name": "<name>",
    "notificationCreatedAt": "<notificationCreatedAt>",
    "notificationId": "<notificationId>",
    "orgId": "<orgId>",
    "position": 1,
    "status": "<status>",
    "surtidaAt": "<surtidaAt>"
  }
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`creditsSummary`

GET/_x/query/credits-summary

Miembro de la firmaPermiso: notification:readHerramienta MCP: creditsSummary

How many sends the caller's firm has left: `balance` is how many recipients can still be notified (one credit per recipient, consumed on send); `mode` is 'free' while Notificado sells nothing (never tell the lawyer to buy) or 'paid'; `trial` is { granted, remaining, expiresAt (UTC) } of the free sends, or null. For lawyers and paralegals; the credit statement is ledgerList (billing role). Read-only.

Parámetros de creditsSummary
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/credits-summary?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/credits-summary?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`getNotification`

GET/v1/get-notification

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: getNotification

One notification: recipients, attachments with SHA-256 and the evidence timeline (UTC). Opens are indicio.

Parámetros de getNotification
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí

curl

curl 'https://www.notificado.co/v1/get-notification?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/get-notification?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "attachments": [
    {
      "bytes": 1,
      "delivery": "attached",
      "filename": "<filename>",
      "id": "<id>",
      "kind": "auto_admisorio",
      "mime": "<mime>",
      "pageCount": 1,
      "position": 1,
      "retainUntil": "<retainUntil>",
      "sha256": "<sha256>"
    }
  ],
  "bodyText": "<bodyText>",
  "caseId": "<caseId>",
  "createdAt": "<createdAt>",
  "emlSha256": "<emlSha256>",
  "frozenAt": "<frozenAt>",
  "id": "<id>",
  "mensaje": "<mensaje>",
  "orgId": "<orgId>",
  "providencia": "<providencia>",
  "providenciaFecha": "<providenciaFecha>",
  "recipients": [
    {
      "delivered": true,
      "email": "<email>",
      "failure": {
        "at": "<at>",
        "code": "<code>",
        "detail": "<detail>",
        "kind": "rejected",
        "refunded": true
      },
      "id": "<id>",
      "messageId": "<messageId>",
      "name": "<name>",
      "provenance": {
        "evidenceDocumentIds": [
          null
        ],
        "juramentoVersion": "<juramentoVersion>",
        "overrideReason": "<overrideReason>",
        "source": "comunicaciones_previas",
        "sourceText": "<sourceText>",
        "swornAt": "<swornAt>",
        "swornBy": "<swornBy>"
      },
      "sendUnconfirmed": true,
      "status": "queued"
    }
  ],
  "scheduledFor": "<scheduledFor>",
  "sentAt": "<sentAt>",
  "sentBy": "<sentBy>",
  "signerId": "<signerId>",
  "status": "draft",
  "subject": "<subject>",
  "template": "<template>",
  "terminoDias": 1,
  "tier": "standard",
  "timeline": [
    {
      "hash": "<hash>",
      "id": "<id>",
      "indicio": true,
      "linkedFile": "start",
      "occurredAt": "<occurredAt>",
      "openSignal": "likely_person",
      "payload": {},
      "recipientId": "<recipientId>",
      "recordedAt": "<recordedAt>",
      "seq": "<seq>",
      "type": "<type>"
    }
  ],
  "timestampProviderIds": [
    "<timestampProviderIds>"
  ],
  "transportId": "<transportId>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
404 X_NOT_FOUND — the read matched no row for this input
429 X_RATE_LIMITED — retry after Retry-After seconds

`getSendConfirmation`

GET/v1/get-send-confirmation

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: getSendConfirmation

One send request: pending, confirmed or expired (after 24 h).

Parámetros de getSendConfirmation
Nombre	Dónde	Tipo	Obligatorio
`confirmationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí

curl

curl 'https://www.notificado.co/v1/get-send-confirmation?confirmationId=<confirmationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/get-send-confirmation?confirmationId=<confirmationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "attachments": [
    {
      "bytes": 1,
      "filename": "<filename>",
      "sha256": "<sha256>"
    }
  ],
  "confirmedAt": "<confirmedAt>",
  "confirmedBy": "<confirmedBy>",
  "cost": {
    "attachedBytes": 1,
    "canPay": true,
    "creditsPerRecipient": 1,
    "linkedBytes": 1,
    "linkedCreditsPerRecipient": 1,
    "reason": "ok",
    "recipients": 1,
    "shortBy": 1,
    "total": 1
  },
  "createdAt": "<createdAt>",
  "currentSha256": "<currentSha256>",
  "draftSha256": "<draftSha256>",
  "expiresAt": "<expiresAt>",
  "id": "<id>",
  "notificationId": "<notificationId>",
  "orgId": "<orgId>",
  "recipients": [
    {
      "email": "<email>",
      "name": "<name>"
    }
  ],
  "requestedBy": "<requestedBy>",
  "requestedWhen": "now",
  "status": "pending",
  "subject": "<subject>",
  "tokenId": "<tokenId>",
  "tokenName": "<tokenName>",
  "tokenPrefix": "<tokenPrefix>",
  "unchanged": true
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
404 X_NOT_FOUND — the read matched no row for this input
429 X_RATE_LIMITED — retry after Retry-After seconds

`listMessageTemplates`

GET/v1/list-message-templates

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: listMessageTemplates

The firm's message templates and merge fields; pass an id as messageTemplateId.

Parámetros de listMessageTemplates
Nombre	Dónde	Tipo	Obligatorio
`archived`	Consulta	`boolean`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/list-message-templates?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/list-message-templates?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listPendingApprovals`

GET/_x/query/list-pending-approvals

Miembro de la firmaPermiso: notification:read

listPendingApprovals

Parámetros de listPendingApprovals
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/list-pending-approvals?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/list-pending-approvals?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`listPendingSends`

GET/v1/list-pending-sends

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: listPendingSends

Send requests still waiting for a lawyer to confirm, newest first.

Parámetros de listPendingSends
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/list-pending-sends?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/list-pending-sends?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`memorialReadiness`

GET/v1/memorial-readiness

Miembro de la firmaPermiso: memorial:read/v1 · token BearerHerramienta MCP: memorialReadiness

Whether createMemorial can run now for a notification, and why not.

Parámetros de memorialReadiness
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/memorial-readiness?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/memorial-readiness?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`notificationApprovals`

GET/_x/query/notification-approvals

Miembro de la firmaPermiso: notification:read

notificationApprovals

Parámetros de notificationApprovals
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/notification-approvals?notificationId=<notificationId>&orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/notification-approvals?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`notificationCourtOutcomes`

GET/v1/notification-court-outcomes

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: notificationCourtOutcomes

What the juzgado decided on one notification, newest first; the first row is current. Not evidence.

Parámetros de notificationCourtOutcomes
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/notification-court-outcomes?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/notification-court-outcomes?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`notificationList`

GET/v1/notification-list

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: notificationList

Notifications, newest first; filter by q, status and from/to (Bogotá days); page with the last row's cursor.

Parámetros de notificationList
Nombre	Dónde	Tipo	Obligatorio
`cursor`	Consulta	`string 1–64`	No
`from`	Consulta	`string 1–10`	No
`limit`	Consulta	`integer 1–200`	No
`orgId`	Consulta	`string (uuid)`	Sí
`q`	Consulta	`string 1–200`	No
`status`	Consulta	`"draft" \| "awaiting_approval" \| "scheduled" \| "sent" \| "delivered" \| "acknowledged" \| "bounced" \| "failed"`	No
`to`	Consulta	`string 1–10`	No
`_first`	Consulta	`integer 1–200`page size; present, the response is the page envelope rather than the bare rows (1 to 200)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/notification-list?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/notification-list?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`notificationMemorials`

GET/v1/notification-memorials

Miembro de la firmaPermiso: memorial:read/v1 · token BearerHerramienta MCP: notificationMemorials

A notification's memoriales with their hashes; poll it after createMemorial.

Parámetros de notificationMemorials
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–200`	No
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/notification-memorials?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/notification-memorials?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`notificationTrace`

GET/v1/notification-trace

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: notificationTrace

One notification’s evidence events in chain order (UTC). Opens are indicio.

Parámetros de notificationTrace
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí

curl

curl 'https://www.notificado.co/v1/notification-trace?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/notification-trace?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "events": [
    {
      "hash": "<hash>",
      "ipAddress": "<ipAddress>",
      "isIndicio": true,
      "linkedFile": "start",
      "occurredAt": "<occurredAt>",
      "recipient": "<recipient>",
      "remoteMtaIp": "<remoteMtaIp>",
      "seq": "<seq>",
      "smtpResponse": "<smtpResponse>",
      "type": "<type>",
      "userAgent": "<userAgent>"
    }
  ],
  "id": "<id>",
  "orgId": "<orgId>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
404 X_NOT_FOUND — the read matched no row for this input
429 X_RATE_LIMITED — retry after Retry-After seconds

`notificationsPerWeek`

GET/_x/query/notifications-per-week

Miembro de la firmaPermiso: notification:readHerramienta MCP: notificationsPerWeek

The caller's firm's notifications per week for the last `weeks` weeks (default 12), oldest first, weeks starting Monday 00:00 America/Bogota (weekStart, YYYY-MM-DD; the last one is the current week, still filling): sent, delivered (every recipient reached the receiving server and none bounced), constancia (a constancia was issued) and bounced (a recipient bounced or was refused; a complaint counts as delivered). Counts only. Read-only.

Parámetros de notificationsPerWeek
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`weeks`	Consulta	`integer 1–52`	No
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/notifications-per-week?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/notifications-per-week?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`openBatchRequests`

GET/_x/query/open-batch-requests

Miembro de la firmaPermiso: notification:read

openBatchRequests

Parámetros de openBatchRequests
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/open-batch-requests?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/open-batch-requests?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`recentApprovalDecisions`

GET/_x/query/recent-approval-decisions

Miembro de la firmaPermiso: notification:read

recentApprovalDecisions

Parámetros de recentApprovalDecisions
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–100`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/recent-approval-decisions?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/recent-approval-decisions?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`recentNotifications`

GET/v1/recent-notifications

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: recentNotifications

The 10 newest notifications and where their evidence stands.

Parámetros de recentNotifications
Nombre	Dónde	Tipo	Obligatorio
`limit`	Consulta	`integer 1–10`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/recent-notifications?orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/recent-notifications?orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`recentSendsTo`

GET/v1/recent-sends-to

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: recentSendsTo

Earlier sends to these addresses in this case, or, without caseId, in the firm’s correos con constancia (default 30 days). A warning for the lawyer, never a block.

Parámetros de recentSendsTo
Nombre	Dónde	Tipo	Obligatorio
`caseId`	Consulta	`string (uuid) \| null`	No
`days`	Consulta	`integer 1–365`	No
`emails`	Consulta	`array of string (email)`	Sí
`exclude`	Consulta	`string (uuid)`	No
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/v1/recent-sends-to?emails=&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/recent-sends-to?emails=&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`requestableDrafts`

GET/_x/query/requestable-drafts

Miembro de la firmaPermiso: notification:read

requestableDrafts

Parámetros de requestableDrafts
Nombre	Dónde	Tipo	Obligatorio
`orgId`	Consulta	`string (uuid)`	Sí
`_first`	Consulta	`integer 1–500`page size; present, the response is the page envelope rather than the bare rows (1 to 500)	No
`_after`	Consulta	`string`the nextCursor a previous page answered; needs _first	No

curl

curl 'https://www.notificado.co/_x/query/requestable-drafts?orgId=<orgId>' \
  -b cookies.txt

TypeScript

const response = await fetch('https://www.notificado.co/_x/query/requestable-drafts?orgId=<orgId>', {
  headers: { cookie: sessionCookie },
});
const result = await response.json();

Ejemplo de respuesta

200

[
  null
]

Errores

400 X_INPUT_INVALID or X_CURSOR_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
429 X_RATE_LIMITED — retry after Retry-After seconds

`sendCost`

GET/v1/send-cost

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: sendCost

What a send costs (per recipient: 1 credit + one per 10 MB linked; the total) and whether the firm can pay it now: canPay, shortBy, reason.

Parámetros de sendCost
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí

curl

curl 'https://www.notificado.co/v1/send-cost?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/send-cost?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "attachedBytes": 1,
  "canPay": true,
  "creditsPerRecipient": 1,
  "id": "<id>",
  "linkedBytes": 1,
  "linkedCreditsPerRecipient": 1,
  "orgId": "<orgId>",
  "paidAvailable": 1,
  "reason": "ok",
  "recipients": 1,
  "shortBy": 1,
  "total": 1,
  "trialAvailable": 1
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
404 X_NOT_FOUND — the read matched no row for this input
429 X_RATE_LIMITED — retry after Retry-After seconds

`sendTiming`

GET/v1/send-timing

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: sendTiming

What sending a draft NOW would read as: the instant, the next opening of a business day (nextOpen), whether two readings of the send date differ (divergent) and each date, the hold policy, whether scheduling is on. Dates are estimates; the judge decides.

Parámetros de sendTiming
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Consulta	`string (uuid)`	Sí
`orgId`	Consulta	`string (uuid)`	Sí

curl

curl 'https://www.notificado.co/v1/send-timing?notificationId=<notificationId>&orgId=<orgId>' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN"

TypeScript

const response = await fetch('https://www.notificado.co/v1/send-timing?notificationId=<notificationId>&orgId=<orgId>', {
  headers: { authorization: `Bearer ${token}` },
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "calendarVersion": "<calendarVersion>",
  "conservative": {
    "deemedSentOn": "<deemedSentOn>",
    "surtidaOn": "<surtidaOn>"
  },
  "divergent": true,
  "holdMs": 1,
  "id": "<id>",
  "maxAutoHoldMs": 1,
  "nextOpen": "<nextOpen>",
  "now": "<now>",
  "orgId": "<orgId>",
  "policy": "opt_in",
  "reason": "in_hours",
  "scheduling": "off",
  "sendWindowVersion": "<sendWindowVersion>",
  "standard": {
    "surtidaOn": "<surtidaOn>"
  }
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
404 X_NOT_FOUND — the read matched no row for this input
429 X_RATE_LIMITED — retry after Retry-After seconds

`addRecipient`

POST/api/add-recipient

Miembro de la firmaPermiso: or(and(notification:send, notification:send), and(and(approval:request, not(notification:send)), approval:request))

addRecipient

Parámetros de addRecipient
Nombre	Dónde	Tipo	Obligatorio
`email`	Cuerpo	`string (email)`	Sí
`evidenceDocumentIds`	Cuerpo	`array of string (uuid)`	Sí
`juramento`	Cuerpo	`boolean`	Sí
`juramentoText`	Cuerpo	`string 1–4000`	No
`name`	Cuerpo	`string 1–300`	Sí
`notificationId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`overrideReason`	Cuerpo	`string 1–2000 \| null`	No
`saveToPartyId`	Cuerpo	`string (uuid) \| null`	No
`source`	Cuerpo	`"comunicaciones_previas" \| "camara_de_comercio" \| "rut" \| "contrato" \| "web_oficial" \| "otro"`	Sí
`sourceText`	Cuerpo	`string 1–2000`	Sí

curl

curl -X POST 'https://www.notificado.co/api/add-recipient' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{
  "email": "<email>",
  "evidenceDocumentIds": [],
  "juramento": true,
  "name": "<name>",
  "notificationId": "<notificationId>",
  "orgId": "<orgId>",
  "source": "comunicaciones_previas",
  "sourceText": "<sourceText>"
}'

TypeScript

const response = await fetch('https://www.notificado.co/api/add-recipient', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "email": "<email>",
    "evidenceDocumentIds": [],
    "juramento": true,
    "name": "<name>",
    "notificationId": "<notificationId>",
    "orgId": "<orgId>",
    "source": "comunicaciones_previas",
    "sourceText": "<sourceText>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "email": "<email>",
  "id": "<id>",
  "name": "<name>",
  "notificationId": "<notificationId>",
  "status": "queued"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`approveSend`

POST/api/approve-send

Miembro de la firmaPermiso: and(notification:send, notification:send)

approveSend

Parámetros de approveSend
Nombre	Dónde	Tipo	Obligatorio
`approvalId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`swornRecipientIds`	Cuerpo	`string (uuid) \| array of string (uuid)`	No
`when`	Cuerpo	`"now" \| "next_business_open"`	No

curl

curl -X POST 'https://www.notificado.co/api/approve-send' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"approvalId":"<approvalId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/approve-send', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "approvalId": "<approvalId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "caseId": "<caseId>",
  "createdAt": "2026-09-25T15:00:00Z",
  "emlSha256": "<emlSha256>",
  "frozenAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "scheduledFor": "2026-09-25T15:00:00Z",
  "sentAt": "2026-09-25T15:00:00Z",
  "status": "draft",
  "subject": "<subject>",
  "tier": "standard"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`archiveMessageTemplate`

POST/api/archive-message-template

Miembro de la firmaPermiso: notification:send

archiveMessageTemplate

Parámetros de archiveMessageTemplate
Nombre	Dónde	Tipo	Obligatorio
`archived`	Cuerpo	`boolean \| "true" \| "false"`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`templateId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/archive-message-template' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"archived":true,"orgId":"<orgId>","templateId":"<templateId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/archive-message-template', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "archived": true,
    "orgId": "<orgId>",
    "templateId": "<templateId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "archivedAt": "2026-09-25T15:00:00Z",
  "body": "<body>",
  "createdAt": "2026-09-25T15:00:00Z",
  "especialidad": "<especialidad>",
  "id": "<id>",
  "name": "<name>",
  "seedKey": "<seedKey>",
  "subject": "<subject>",
  "updatedAt": "2026-09-25T15:00:00Z"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`cancelScheduledSend`

POST/api/cancel-scheduled-send

Miembro de la firmaPermiso: and(notification:send, notification:send)

cancelScheduledSend

Parámetros de cancelScheduledSend
Nombre	Dónde	Tipo	Obligatorio
`notificationId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/cancel-scheduled-send' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"notificationId":"<notificationId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/cancel-scheduled-send', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "notificationId": "<notificationId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "caseId": "<caseId>",
  "createdAt": "2026-09-25T15:00:00Z",
  "emlSha256": "<emlSha256>",
  "frozenAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "scheduledFor": "2026-09-25T15:00:00Z",
  "sentAt": "2026-09-25T15:00:00Z",
  "status": "draft",
  "subject": "<subject>",
  "tier": "standard"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`confirmBatchSend`

POST/api/confirm-batch-send

Miembro de la firmaPermiso: and(notification:send, notification:send)

confirmBatchSend

Parámetros de confirmBatchSend
Nombre	Dónde	Tipo	Obligatorio
`idempotencyKey`	Cuerpo	`string 8–80`	Sí
`importId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`rowIds`	Cuerpo	`string (uuid) \| array of string (uuid)`	Sí
`swornRowIds`	Cuerpo	`string (uuid) \| array of string (uuid)`	No

curl

curl -X POST 'https://www.notificado.co/api/confirm-batch-send' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{
  "idempotencyKey": "<idempotencyKey>",
  "importId": "<importId>",
  "orgId": "<orgId>",
  "rowIds": "<rowIds>"
}'

TypeScript

const response = await fetch('https://www.notificado.co/api/confirm-batch-send', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "idempotencyKey": "<idempotencyKey>",
    "importId": "<importId>",
    "orgId": "<orgId>",
    "rowIds": "<rowIds>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "createdAt": "2026-09-25T15:00:00Z",
  "failedCount": -9007199254740991,
  "finishedAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "importId": "<importId>",
  "juramentoVersion": "<juramentoVersion>",
  "note": "<note>",
  "requestedBy": "<requestedBy>",
  "scheduledCount": -9007199254740991,
  "sentCount": -9007199254740991,
  "status": "requested",
  "swornAt": "2026-09-25T15:00:00Z",
  "swornBy": "<swornBy>",
  "total": -9007199254740991
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`confirmSend`

POST/api/confirm-send

Miembro de la firmaPermiso: and(notification:send, notification:send)

confirmSend

Parámetros de confirmSend
Nombre	Dónde	Tipo	Obligatorio
`confirmationId`	Cuerpo	`string (uuid)`	Sí
`draftSha256`	Cuerpo	`string 64–64`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`returnTo`	Cuerpo	`string 1–2048`	No
`swornRecipientIds`	Cuerpo	`string (uuid) \| array of string (uuid)`	No
`when`	Cuerpo	`"now" \| "next_business_open"`	No

curl

curl -X POST 'https://www.notificado.co/api/confirm-send' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"confirmationId":"<confirmationId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/confirm-send', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "confirmationId": "<confirmationId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "caseId": "<caseId>",
  "createdAt": "2026-09-25T15:00:00Z",
  "emlSha256": "<emlSha256>",
  "frozenAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "scheduledFor": "2026-09-25T15:00:00Z",
  "sentAt": "2026-09-25T15:00:00Z",
  "status": "draft",
  "subject": "<subject>",
  "tier": "standard"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`createMemorial`

POST/v1/create-memorial

Miembro de la firmaPermiso: memorial:write/v1 · token BearerIdempotency-KeyHerramienta MCP: createMemorial

Generate the memorial DRAFT (DOCX and PDF) for the juzgado; the lawyer signs and files it.

Parámetros de createMemorial
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`notificationId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/v1/create-memorial' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"notificationId":"<notificationId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/create-memorial', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID() },
  body: JSON.stringify({
    "notificationId": "<notificationId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "charge": "free",
  "jobId": "<jobId>",
  "memorialId": "<memorialId>",
  "templateId": "<templateId>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`createMessageTemplate`

POST/v1/create-message-template

Miembro de la firmaPermiso: notification:send/v1 · token BearerIdempotency-KeyHerramienta MCP: createMessageTemplate

Create a template with merge fields. Never write the art. 8 statements: they are appended.

Parámetros de createMessageTemplate
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`body`	Cuerpo	`string 1–20000`	Sí
`especialidad`	Cuerpo	`string 1–60 \| null`	No
`name`	Cuerpo	`string 1–120`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`subject`	Cuerpo	`string 1–998`	Sí

curl

curl -X POST 'https://www.notificado.co/v1/create-message-template' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{
  "body": "<body>",
  "name": "<name>",
  "orgId": "<orgId>",
  "subject": "<subject>"
}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/create-message-template', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID() },
  body: JSON.stringify({
    "body": "<body>",
    "name": "<name>",
    "orgId": "<orgId>",
    "subject": "<subject>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "archivedAt": "2026-09-25T15:00:00Z",
  "body": "<body>",
  "createdAt": "2026-09-25T15:00:00Z",
  "especialidad": "<especialidad>",
  "id": "<id>",
  "name": "<name>",
  "seedKey": "<seedKey>",
  "subject": "<subject>",
  "updatedAt": "2026-09-25T15:00:00Z"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`downloadMemorial`

POST/v1/download-memorial

Miembro de la firmaPermiso: memorial:read/v1 · token BearerHerramienta MCP: downloadMemorial

A memorial as docx or pdf bytes (base64), re-hashed first. Recorded.

Parámetros de downloadMemorial
Nombre	Dónde	Tipo	Obligatorio
`format`	Cuerpo	`"docx" \| "pdf"`	Sí
`memorialId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/v1/download-memorial' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"format":"docx","memorialId":"<memorialId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/download-memorial', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "format": "docx",
    "memorialId": "<memorialId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "bytes": 0,
  "contentBase64": "<contentBase64>",
  "contentType": "<contentType>",
  "filename": "<filename>",
  "format": "docx",
  "memorialId": "<memorialId>",
  "sha256": "<sha256>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`exportEvents`

POST/v1/export-events

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: exportEvents

Excel workbook (base64) of evidence events, a line each, exportNotifications' filters and cursor.

Parámetros de exportEvents
Nombre	Dónde	Tipo	Obligatorio
`cursor`	Cuerpo	`string 1–1024`	No
`from`	Cuerpo	`string 1–10`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`q`	Cuerpo	`string 1–200`	No
`status`	Cuerpo	`"draft" \| "awaiting_approval" \| "scheduled" \| "sent" \| "delivered" \| "acknowledged" \| "bounced" \| "failed"`	No
`to`	Cuerpo	`string 1–10`	No

curl

curl -X POST 'https://www.notificado.co/v1/export-events' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/export-events', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "filename": "<filename>",
  "nextCursor": "<nextCursor>",
  "rows": -9007199254740991,
  "truncated": true,
  "xlsx": "<xlsx>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`exportNotifications`

POST/v1/export-notifications

Miembro de la firmaPermiso: notification:read/v1 · token BearerHerramienta MCP: exportNotifications

Excel workbook (base64) of notifications, a line per recipient, notificationList's filters; 5,000 a call, then cursor.

Parámetros de exportNotifications
Nombre	Dónde	Tipo	Obligatorio
`cursor`	Cuerpo	`string 1–1024`	No
`from`	Cuerpo	`string 1–10`	No
`orgId`	Cuerpo	`string (uuid)`	Sí
`q`	Cuerpo	`string 1–200`	No
`status`	Cuerpo	`"draft" \| "awaiting_approval" \| "scheduled" \| "sent" \| "delivered" \| "acknowledged" \| "bounced" \| "failed"`	No
`to`	Cuerpo	`string 1–10`	No

curl

curl -X POST 'https://www.notificado.co/v1/export-notifications' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/export-notifications', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "filename": "<filename>",
  "nextCursor": "<nextCursor>",
  "rows": -9007199254740991,
  "truncated": true,
  "xlsx": "<xlsx>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`rejectSend`

POST/api/reject-send

Miembro de la firmaPermiso: and(notification:send, notification:send)

rejectSend

Parámetros de rejectSend
Nombre	Dónde	Tipo	Obligatorio
`approvalId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`reason`	Cuerpo	`string 1–1000`	Sí

curl

curl -X POST 'https://www.notificado.co/api/reject-send' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"approvalId":"<approvalId>","orgId":"<orgId>","reason":"<reason>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/reject-send', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "approvalId": "<approvalId>",
    "orgId": "<orgId>",
    "reason": "<reason>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "approvedBy": "<approvedBy>",
  "createdAt": "2026-09-25T15:00:00Z",
  "decidedAt": "2026-09-25T15:00:00Z",
  "draftedBy": "<draftedBy>",
  "id": "<id>",
  "note": "<note>",
  "notificationId": "<notificationId>",
  "rejectReason": "<rejectReason>",
  "rejectedBy": "<rejectedBy>",
  "requestedVia": "panel",
  "requestedWhen": "now",
  "status": "pending",
  "withdrawnBy": "<withdrawnBy>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`reportCourtOutcome`

POST/v1/report-court-outcome

Miembro de la firmaPermiso: notification:send/v1 · token BearerIdempotency-KeyHerramienta MCP: reportCourtOutcome

Report what the juzgado decided on a SENT notification; a later report corrects it. Not evidence.

Parámetros de reportCourtOutcome
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`attachmentUploadId`	Cuerpo	`"" \| string (uuid)`	No
`court`	Cuerpo	`string 1–300`	No
`decidedOn`	Cuerpo	`string 8–10`	Sí
`notificationId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`outcome`	Cuerpo	`"accepted" \| "rejected" \| "nulidad_requested"`	Sí
`reason`	Cuerpo	`string 1–2000`	No

curl

curl -X POST 'https://www.notificado.co/v1/report-court-outcome' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{
  "decidedOn": "<decidedOn>",
  "notificationId": "<notificationId>",
  "orgId": "<orgId>",
  "outcome": "accepted"
}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/report-court-outcome', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID() },
  body: JSON.stringify({
    "decidedOn": "<decidedOn>",
    "notificationId": "<notificationId>",
    "orgId": "<orgId>",
    "outcome": "accepted"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "court": "<court>",
  "createdAt": "2026-09-25T15:00:00Z",
  "decidedOn": "<decidedOn>",
  "id": "<id>",
  "notificationId": "<notificationId>",
  "outcome": "accepted",
  "reason": "<reason>",
  "source": "customer"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`requestBatchSend`

POST/api/request-batch-send

Miembro de la firmaPermiso: and(and(approval:request, not(notification:send)), approval:request)

requestBatchSend

Parámetros de requestBatchSend
Nombre	Dónde	Tipo	Obligatorio
`importId`	Cuerpo	`string (uuid)`	Sí
`note`	Cuerpo	`string 1–1000`	No
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/request-batch-send' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"importId":"<importId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/request-batch-send', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "importId": "<importId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "createdAt": "2026-09-25T15:00:00Z",
  "failedCount": -9007199254740991,
  "finishedAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "importId": "<importId>",
  "juramentoVersion": "<juramentoVersion>",
  "note": "<note>",
  "requestedBy": "<requestedBy>",
  "scheduledCount": -9007199254740991,
  "sentCount": -9007199254740991,
  "status": "requested",
  "swornAt": "2026-09-25T15:00:00Z",
  "swornBy": "<swornBy>",
  "total": -9007199254740991
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`requestSendApproval`

POST/api/request-send-approval

Miembro de la firmaPermiso: and(approval:request, not(notification:send))

requestSendApproval

Parámetros de requestSendApproval
Nombre	Dónde	Tipo	Obligatorio
`note`	Cuerpo	`string 1–1000`	No
`notificationId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`when`	Cuerpo	`"now" \| "next_business_open"`	No

curl

curl -X POST 'https://www.notificado.co/api/request-send-approval' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"notificationId":"<notificationId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/request-send-approval', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "notificationId": "<notificationId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "approvalId": "<approvalId>",
  "approvalUrl": "<approvalUrl>",
  "noDecider": true,
  "notificationId": "<notificationId>",
  "status": "awaiting_approval"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`sendNotification`

POST/v1/send-notification

Miembro de la firmaPermiso: or(and(approval:request, not(notification:send)), notification:send)/v1 · token BearerIdempotency-KeyHerramienta MCP: sendNotification

REQUEST a send; REQUIRES HUMAN CONFIRMATION: verified lawyer: awaiting_confirmation + confirmUrl; others (unverified, paralegal): awaiting_approval + approvalUrl. Once; never to test. Optional when (now | next_business_open) is a PROPOSAL shown to the lawyer: nothing is sent or scheduled by it.

Parámetros de sendNotification
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`confirm`	Cuerpo	`true`	Sí
`note`	Cuerpo	`string 1–1000`	No
`notificationId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`swornRecipientIds`	Cuerpo	`string (uuid) \| array of string (uuid)`	No
`when`	Cuerpo	`"now" \| "next_business_open"`	No

curl

curl -X POST 'https://www.notificado.co/v1/send-notification' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"confirm":true,"notificationId":"<notificationId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/send-notification', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID() },
  body: JSON.stringify({
    "confirm": true,
    "notificationId": "<notificationId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "caseId": "<caseId>",
  "createdAt": "2026-09-25T15:00:00Z",
  "emlSha256": "<emlSha256>",
  "frozenAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "scheduledFor": "2026-09-25T15:00:00Z",
  "sentAt": "2026-09-25T15:00:00Z",
  "status": "draft",
  "subject": "<subject>",
  "tier": "standard"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`sendScheduledNow`

POST/api/send-scheduled-now

Miembro de la firmaPermiso: and(notification:send, notification:send)Idempotency-Key

sendScheduledNow

Parámetros de sendScheduledNow
Nombre	Dónde	Tipo	Obligatorio
`Idempotency-Key`	Encabezado	`string ≤ 255`Replays the first response for a repeated key.	No
`notificationId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/send-scheduled-now' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H "idempotency-key: $(uuidgen)" \
  -H 'content-type: application/json' \
  -d '{"notificationId":"<notificationId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/send-scheduled-now', {
  method: 'POST',
  headers: { 'content-type': 'application/json', 'idempotency-key': crypto.randomUUID(), origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "notificationId": "<notificationId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "caseId": "<caseId>",
  "createdAt": "2026-09-25T15:00:00Z",
  "emlSha256": "<emlSha256>",
  "frozenAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "scheduledFor": "2026-09-25T15:00:00Z",
  "sentAt": "2026-09-25T15:00:00Z",
  "status": "draft",
  "subject": "<subject>",
  "tier": "standard"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
409 X_IDEMPOTENCY_CONFLICT
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`switchChannel`

POST/api/switch-channel

Miembro de la firmaPermiso: and(notification:send, notification:send)

switchChannel

Parámetros de switchChannel
Nombre	Dónde	Tipo	Obligatorio
`email`	Cuerpo	`string 1–320`	Sí
`evidenceDocumentIds`	Cuerpo	`array of string 1–64`	No
`juramento`	Cuerpo	`boolean \| string 0–8`	No
`name`	Cuerpo	`string 0–300`	No
`notificationId`	Cuerpo	`string 1–64`	No
`orgId`	Cuerpo	`string 1–64`	Sí
`overrideReason`	Cuerpo	`string 0–2000 \| null`	No
`recipientId`	Cuerpo	`string 1–64`	Sí
`source`	Cuerpo	`string 1–64`	Sí
`sourceText`	Cuerpo	`string 1–2000`	Sí
`when`	Cuerpo	`string 0–32`	No

curl

curl -X POST 'https://www.notificado.co/api/switch-channel' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{
  "email": "<email>",
  "orgId": "<orgId>",
  "recipientId": "<recipientId>",
  "source": "<source>",
  "sourceText": "<sourceText>"
}'

TypeScript

const response = await fetch('https://www.notificado.co/api/switch-channel', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "email": "<email>",
    "orgId": "<orgId>",
    "recipientId": "<recipientId>",
    "source": "<source>",
    "sourceText": "<sourceText>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "caseId": "<caseId>",
  "createdAt": "2026-09-25T15:00:00Z",
  "emlSha256": "<emlSha256>",
  "frozenAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "scheduledFor": "2026-09-25T15:00:00Z",
  "sentAt": "2026-09-25T15:00:00Z",
  "status": "draft",
  "subject": "<subject>",
  "tier": "standard"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`updateMessageTemplate`

POST/v1/update-message-template

Miembro de la firmaPermiso: notification:send/v1 · token BearerHerramienta MCP: updateMessageTemplate

Rewrite a template; drafts already composed keep their text.

Parámetros de updateMessageTemplate
Nombre	Dónde	Tipo	Obligatorio
`body`	Cuerpo	`string 1–20000`	Sí
`especialidad`	Cuerpo	`string 1–60 \| null`	No
`name`	Cuerpo	`string 1–120`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`subject`	Cuerpo	`string 1–998`	Sí
`templateId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/v1/update-message-template' \
  -H "authorization: Bearer $NOTIFICADO_TOKEN" \
  -H 'content-type: application/json' \
  -d '{
  "body": "<body>",
  "name": "<name>",
  "orgId": "<orgId>",
  "subject": "<subject>",
  "templateId": "<templateId>"
}'

TypeScript

const response = await fetch('https://www.notificado.co/v1/update-message-template', {
  method: 'POST',
  headers: { authorization: `Bearer ${token}`, 'content-type': 'application/json' },
  body: JSON.stringify({
    "body": "<body>",
    "name": "<name>",
    "orgId": "<orgId>",
    "subject": "<subject>",
    "templateId": "<templateId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "archivedAt": "2026-09-25T15:00:00Z",
  "body": "<body>",
  "createdAt": "2026-09-25T15:00:00Z",
  "especialidad": "<especialidad>",
  "id": "<id>",
  "name": "<name>",
  "seedKey": "<seedKey>",
  "subject": "<subject>",
  "updatedAt": "2026-09-25T15:00:00Z"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`withdrawBatchSend`

POST/api/withdraw-batch-send

Miembro de la firmaPermiso: or(and(and(approval:request, not(notification:send)), approval:request), and(notification:send, notification:send))

withdrawBatchSend

Parámetros de withdrawBatchSend
Nombre	Dónde	Tipo	Obligatorio
`importId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí
`sendId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/withdraw-batch-send' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"importId":"<importId>","orgId":"<orgId>","sendId":"<sendId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/withdraw-batch-send', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "importId": "<importId>",
    "orgId": "<orgId>",
    "sendId": "<sendId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "createdAt": "2026-09-25T15:00:00Z",
  "failedCount": -9007199254740991,
  "finishedAt": "2026-09-25T15:00:00Z",
  "id": "<id>",
  "importId": "<importId>",
  "juramentoVersion": "<juramentoVersion>",
  "note": "<note>",
  "requestedBy": "<requestedBy>",
  "scheduledCount": -9007199254740991,
  "sentCount": -9007199254740991,
  "status": "requested",
  "swornAt": "2026-09-25T15:00:00Z",
  "swornBy": "<swornBy>",
  "total": -9007199254740991
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds

`withdrawSendApproval`

POST/api/withdraw-send-approval

Miembro de la firmaPermiso: notification:read

withdrawSendApproval

Parámetros de withdrawSendApproval
Nombre	Dónde	Tipo	Obligatorio
`approvalId`	Cuerpo	`string (uuid)`	Sí
`orgId`	Cuerpo	`string (uuid)`	Sí

curl

curl -X POST 'https://www.notificado.co/api/withdraw-send-approval' \
  -b cookies.txt \
  -H 'origin: https://www.notificado.co' \
  -H 'content-type: application/json' \
  -d '{"approvalId":"<approvalId>","orgId":"<orgId>"}'

TypeScript

const response = await fetch('https://www.notificado.co/api/withdraw-send-approval', {
  method: 'POST',
  headers: { 'content-type': 'application/json', origin: 'https://www.notificado.co', cookie: sessionCookie },
  body: JSON.stringify({
    "approvalId": "<approvalId>",
    "orgId": "<orgId>"
  }),
});
const result = await response.json();

Ejemplo de respuesta

200

{
  "approvedBy": "<approvedBy>",
  "createdAt": "2026-09-25T15:00:00Z",
  "decidedAt": "2026-09-25T15:00:00Z",
  "draftedBy": "<draftedBy>",
  "id": "<id>",
  "note": "<note>",
  "notificationId": "<notificationId>",
  "rejectReason": "<rejectReason>",
  "rejectedBy": "<rejectedBy>",
  "requestedVia": "panel",
  "requestedWhen": "now",
  "status": "pending",
  "withdrawnBy": "<withdrawnBy>"
}

Errores

400 X_INPUT_INVALID
401 X_UNAUTHENTICATED — no credential, or one that did not resolve
403 policy denied
422 X_BODY_INVALID
429 X_RATE_LIMITED — retry after Retry-After seconds