---
title: "Send email (Netcore format)"
method: POST
path: "/v1s/nsend/"
tags: ["Engine — Send"]
---

# Send email (Netcore format)

`POST /v1s/nsend/`

## Request

- Base URL: `https://orbitus.netcorecloud.com`
- URL: `https://orbitus.netcorecloud.com/v1s/nsend/`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
  - API key in header `api_key`

Send an email using **Netcore v6** payload format. Identical flow to `/v1s/ssend`
except the incoming type is `netcore`. Content type keys differ:
`text/html` → `html`, `text/plain` → `plain`, `categories` → `tags`.

## Request body

- NetcorePayload
  - `personalizations` SendGridPersonalization[], required
    - `to` EmailAddress[], required
      - `email` string, email, required
      - `name` string
    - `cc` EmailAddress[]
      - `email` string, email, required
      - `name` string
    - `bcc` EmailAddress[]
      - `email` string, email, required
      - `name` string
    - `subject` string: Overrides top-level subject for this personalization.
  - `from` EmailAddress, required
    - `email` string, email, required
    - `name` string
  - `subject` string
  - `content` NetcoreContent[]
    - `type` 'html' | 'plain', required: `html` maps to `text/html`, `plain` maps to `text/plain`.
    - `value` string, required
  - `tags` string[]: Equivalent to SendGrid `categories`.
  - `settings` object
    - `open_track` boolean
    - `click_track` boolean

## Response `200`

Email relayed successfully.

- EngineSuccessResponse
  - `success` string
  - `req_id` string: Unique request ID: `{rand6}-{clusterID}-{providerID}-{timestamp}-{sequence}-{clientID}-{routeID}`.
  - `message` string

## Other responses

- `400`: Invalid request (empty body, invalid JSON, payload validation, transform error).
- `401`: API key missing or invalid.
- `403`: IP or domain restriction violation.
- `413`: Payload exceeds `max_request_body_size_mb`.
- `500`: Internal server error.
- `502`: Upstream provider returned an error.
- `504`: Upstream provider did not respond in time.

---

[API](https://skmtc.dev/netcorecloud/apis/orbit-router.md) - [All operations](https://skmtc.dev/netcorecloud/apis/orbit-router/llms.txt) - [OpenAPI document](https://skmtc.dev/netcorecloud/apis/orbit-router/revisions/680f0a8ab1a3?raw)