Get a message

GET

messages

{id}

import { createClient } from "@norbelys/sdk";

const norbelys = createClient({ apiKey: process.env.NORBELYS_API_KEY });

const { data, error } = await norbelys.messages.find("msg_a2qzmfyrdj0e");
if (error) {
  throw new Error(error.error.message);
}
console.log(data);

{
  "contactEmail": "[email protected]",
  "contactName": "<string>",
  "id": "act_y3rgwmhkbgxxa2qzmfyrdj0e",
  "personId": "con_mfyrdj0ey3rgwmhkbgxxa2qz",
  "senderId": "snd_y3rgwmhkbgxxa2qzmfyrdj0e",
  "subject": "Quick question, Ada",
  "threadId": "<string>",
  "channel": "email",
  "direction": "outbound",
  "failureCode": "dlq_exhausted",
  "isTest": true,
  "programId": "prg_a2qzmfyrdj0ey3rgwmhkbgxx",
  "status": "sent",
  "stepId": "stp_mfyrdj0ey3rgwmhkbgxxa2qz",
  "object": "message",
  "occurredAt": "2026-06-10T15:04:05.000Z"
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Org-scoped Norbelys API key. Create one in Settings → API keys and send it as Authorization: Bearer ak_….

Path Parameters

string

required

The resource id (path).

Response

OutboundMessage
InboundMessage

contactEmail

string | null

required

The other party's email — the recipient on outbound, the sender on inbound.

Example:

"[email protected]"

contactName

string | null

required

The other party's name.

string

required

The message id.

Example:

"act_y3rgwmhkbgxxa2qzmfyrdj0e"

personId

string | null

required

The linked person, if any.

Example:

"con_mfyrdj0ey3rgwmhkbgxxa2qz"

senderId

string | null

required

The mailbox involved, if any.

Example:

"snd_y3rgwmhkbgxxa2qzmfyrdj0e"

subject

string | null

required

The message subject.

Example:

"Quick question, Ada"

threadId

string | null

required

RFC conversation thread id.

channel

enum<string>

required

Outbound channel: email, call, sms, or linkedin.

Available options:

email,

call,

sms,

linkedin

Example:

"email"

direction

any

required

Message direction — an outbound send.

failureCode

string | null

required

Machine-readable delivery failure or bounce reason; null when none was recorded. Inspect this when status is failed or bounced.

Example:

"dlq_exhausted"

isTest

boolean

required

A test/probe send — surfaced in the log but excluded from campaign rates.

programId

string | null

required

The campaign this message belongs to, when any; null for one-off/test sends.

Example:

"prg_a2qzmfyrdj0ey3rgwmhkbgxx"

status

enum<string>

required

Delivery status: queued, sent, delivered, failed, bounced, or cancelled.

Available options:

queued,

sent,

delivered,

failed,

bounced,

cancelled

Example:

"sent"

stepId

string | null

required

The cadence step that produced this send, when any; null for one-off sends.

Example:

"stp_mfyrdj0ey3rgwmhkbgxxa2qz"

object

any

default:message

Always "message" — identifies the resource type.

occurredAt

any

Send/receive instant (RFC 3339).

Example:

"2026-06-10T15:04:05.000Z"

import { createClient } from "@norbelys/sdk";

const norbelys = createClient({ apiKey: process.env.NORBELYS_API_KEY });

const { data, error } = await norbelys.messages.find("msg_a2qzmfyrdj0e");
if (error) {
  throw new Error(error.error.message);
}
console.log(data);

{
  "contactEmail": "[email protected]",
  "contactName": "<string>",
  "id": "act_y3rgwmhkbgxxa2qzmfyrdj0e",
  "personId": "con_mfyrdj0ey3rgwmhkbgxxa2qz",
  "senderId": "snd_y3rgwmhkbgxxa2qzmfyrdj0e",
  "subject": "Quick question, Ada",
  "threadId": "<string>",
  "channel": "email",
  "direction": "outbound",
  "failureCode": "dlq_exhausted",
  "isTest": true,
  "programId": "prg_a2qzmfyrdj0ey3rgwmhkbgxx",
  "status": "sent",
  "stepId": "stp_mfyrdj0ey3rgwmhkbgxxa2qz",
  "object": "message",
  "occurredAt": "2026-06-10T15:04:05.000Z"
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

{
  "error": {
    "code": "invalid_param",
    "message": "<string>",
    "type": "invalid_request",
    "doc_url": "<string>",
    "hint": "<string>"
  }
}

Analytics

Domains

Fields

Files

Groups

Integrations

Messages

Organization

People

Programs

Segments

Senders

Suppressions

Verify

Authorizations

Path Parameters

Response