---
title: Send a Package
description: Use Somewear's REST API to push a message, location, waypoint, or raw data from your server to personnel and assets in the field.
url: "https://docs.somewear.app/developer/server-integration/send-package/"
updated: "2026-10-22"
requires: {}
facets:
  hardware: []
  client:
    - grid-server:
        since: baseline
  satcom: []
---

**POST** `/api/package` — Auth required

Push data from your system to personnel and assets in the field.

**Headers**

| Name            | Value                                             |
| --------------- | ------------------------------------------------- |
| `Content-Type`  | `application/json`                                |
| `Authorization` | `Bearer <token>` or `Basic <username>:<password>` |
| `x-api-key`     | `<api-key>`                                       |

**Body** — exactly one of `message`, `location`, `waypoint`, or `data`:

### Message

A text message, delivered to one person in a Workspace.

#### curl

```bash
curl https://api.somewear.co/api/package \
  -H "Content-Type: application/json" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -d '{
    "sourceUserId": "1",
    "workspaceId": "1",
    "targetUserId": "1",
    "message": {
      "content": "Hello space!",
      "phone": "+15555555555",
      "email": "somewear@example.com",
      "timestamp": "2023-07-17T22:45:06Z"
    }
  }'
```

#### Body

```json
{
  "sourceUserId": "1",
  "workspaceId": "1",
  "targetUserId": "1",
  "message": {
    "content": "Hello space!",
    "phone": "+15555555555",
    "email": "somewear@example.com",
    "timestamp": "2023-07-17T22:45:06Z"
  }
}
```

### Location

A position report.

#### curl

```bash
curl https://api.somewear.co/api/package \
  -H "Content-Type: application/json" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -d '{
    "sourceUserId": "1",
    "workspaceId": "1",
    "location": {
      "latitude": "37.781001",
      "longitude": "-122.393456",
      "timestamp": "2023-07-17T22:45:06Z"
    }
  }'
```

#### Body

```json
{
  "sourceUserId": "1",
  "workspaceId": "1",
  "location": {
    "latitude": "37.781001",
    "longitude": "-122.393456",
    "timestamp": "2023-07-17T22:45:06Z"
  }
}
```

### Waypoint

A point of interest.

#### curl

```bash
curl https://api.somewear.co/api/package \
  -H "Content-Type: application/json" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -d '{
    "sourceUserId": "1",
    "workspaceId": "1",
    "waypoint": {
      "latitude": "37.819466",
      "longitude": "-122.478628",
      "timestamp": "2023-07-17T22:45:06Z",
      "name": "Golden Gate Bridge"
    }
  }'
```

#### Body

```json
{
  "sourceUserId": "1",
  "workspaceId": "1",
  "waypoint": {
    "latitude": "37.819466",
    "longitude": "-122.478628",
    "timestamp": "2023-07-17T22:45:06Z",
    "name": "Golden Gate Bridge"
  }
}
```

### Data

Raw bytes, base64-encoded — for formats outside Somewear’s own.

#### curl

```bash
curl https://api.somewear.co/api/package \
  -H "Content-Type: application/json" \
  -H "x-api-key: <YOUR_API_KEY>" \
  -d '{
    "sourceUserId": "1",
    "workspaceId": "1",
    "data": {
      "payload": "SGVsbG8gc3BhY2UgZnJvbSBhIG5vbi1Tb21ld2VhciBkYXRhIGZvcm1hdA=="
    }
  }'
```

#### Body

```json
{
  "sourceUserId": "1",
  "workspaceId": "1",
  "data": {
    "payload": "SGVsbG8gc3BhY2UgZnJvbSBhIG5vbi1Tb21ld2VhciBkYXRhIGZvcm1hdA=="
  }
}
```

## Response

### 200

Success, empty body.

### 401

Unauthorized — fix your credentials.

### 403

Forbidden — you don’t have permission to call this endpoint, or to send data to the target.

### 429

Too many requests. See the `Retry-After` response header for the backoff time, in seconds.