Create CoworkerDelivery

POST

api

spaces

coworkerdeliveries

curl --request POST \
  --url https://spaces.nexudus.com/api/spaces/coworkerdeliveries \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>",
  "Location": "<string>",
  "DeliveryType": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/spaces/coworkerdeliveries"

payload = {
    "BusinessId": 123,
    "Name": "<string>",
    "Location": "<string>",
    "DeliveryType": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({BusinessId: 123, Name: '<string>', Location: '<string>', DeliveryType: 123})
};

fetch('https://spaces.nexudus.com/api/spaces/coworkerdeliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

A CoworkerDelivery tracks a delivery (mail, parcel, check, or other item) received on behalf of a customer at a location, along with its current processing status and the customer’s handling preference. Each delivery records who it is for (CoworkerId or ContractContactId), what it is (DeliveryType), and how the customer wants it handled (HandlingPreference). Staff can then mark the delivery through its lifecycle — processed, collected, forwarded, scanned, recycled, shredded, or returned to sender — with corresponding timestamps. Handling preferences control what happens to the delivery:

HandlingPreference	Meaning
StoreForCollection	Hold for the customer to pick up
Forward	Forward to the customer’s address
OpenScanForward	Open, scan contents, then forward the original
OpenScanRecycle	Open, scan contents, then recycle the original
OpenScanShred	Open, scan contents, then shred the original
OpenScanStoreForCollection	Open, scan contents, then hold for collection
Recycle	Recycle the delivery
ReturnToSender	Return the delivery to the sender
Shred	Shred the delivery
DepositCheck	Deposit the enclosed check

Deliveries can also have attached files — for example, a scanned copy of the contents (NewScannedFileDataUrl), a forwarding receipt (NewForwardedFileDataUrl), or a collection signature (NewSignatureUrl).

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerDelivery-Create role.

Enums

eDeliveryType — DeliveryType values

Value	Name
0	None
1	Mail
2	Parcel
3	Check
4	Publicity
5	Other

eDeliveryHandlingPreference

Value	Name
0	None
1	StoreForCollection
2	Forward
3	OpenScanForward
4	OpenScanRecycle
5	OpenScanShred
6	OpenScanStoreForCollection
7	Recycle
8	ReturnToSender
9	Shred
10	DepositCheck
11	Unknown

Request Body

Required Fields

integer

required

ID of the business linked to this record.

string

required

Short label or description identifying the delivery item.

string

required

Physical location where the delivery is being stored (e.g. mailroom shelf).

integer

required

Type of delivery item (Mail, Parcel, Check, Publicity, or Other). Defaults to eDeliveryType.Other.

Optional Fields

integer

ID of the coworker linked to this record.

integer

ID of the contract contact linked to this record.

string

Name of the staff member who received the delivery.

string

Free-text notes about the delivery.

string

URL of a new file to upload as the file data.

boolean

Set to true to remove the current file data file.

string

URL of a new file to upload as the signature.

boolean

Set to true to remove the current signature file.

string

URL of a new file to upload as the scanned file data.

boolean

Set to true to remove the current scanned file data file.

string

URL of a new file to upload as the forwarded file data.

boolean

Set to true to remove the current forwarded file data file.

boolean

Whether the customer has collected the delivery.

boolean

Whether the customer must sign upon collection.

boolean

Whether the customer has signed for the delivery.

boolean

Whether notified is enabled.

string

Date and time the customer collected the delivery.

boolean

Whether billed is enabled.

integer

How the customer wants this delivery handled (e.g. StoreForCollection, Forward, Shred). See eDeliveryHandlingPreference? enum above.

boolean

Whether the enclosed check has been deposited.

boolean

Whether the delivery has been forwarded to the customer.

boolean

Whether the delivery contents have been scanned.

boolean

Whether the delivery has been recycled.

boolean

Whether the delivery has been shredded.

boolean

Whether the delivery is being held for customer collection.

boolean

Whether the delivery has been returned to sender.

string

Date and time the check was deposited.

string

Date and time the delivery was forwarded.

string

Date and time the delivery contents were scanned.

string

Date and time the delivery was recycled.

string

Date and time the delivery was shredded.

string

Date and time the delivery was placed in storage for collection.

string

Date and time the delivery was returned to sender.

string

ID of the forwarding address unique associated with this record.

string

ID of the check deposited product unique associated with this record.

string

ID of the forwarded product unique associated with this record.

string

ID of the scanned product unique associated with this record.

string

ID of the recycled product unique associated with this record.

string

ID of the shredded product unique associated with this record.

string

ID of the stored for collection product unique associated with this record.

string

ID of the returned to sender product unique associated with this record.

string

ID of the collected product unique associated with this record.

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/spaces/coworkerdeliveries" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": "",
    "Location": "",
    "DeliveryType": 0
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/spaces/coworkerdeliveries',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      BusinessId: 0,
      Name: '',
      Location: '',
      DeliveryType: 0
    })
  }
);

const data = await response.json();

import requests

response = requests.post(
    'https://spaces.nexudus.com/api/spaces/coworkerdeliveries',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Name': '',
        'Location': '',
        'DeliveryType': 0
    }
)

data = response.json()

Response

200

integer

HTTP status code. 200 on success.

string

A human-readable message confirming the creation.

object

Contains the Id of the newly created record.

boolean

true if the coworkerdelivery was created successfully.

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "CoworkerDelivery was successfully created.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

string

A summary of the validation error(s), in the format PropertyName: error message.

any

null on validation failure.

object[]

Array of validation errors.

Show child attributes

any

The value that was submitted for the field, or null if missing.

string

The validation error message.

string

The name of the property that failed validation.

boolean

false when the request fails validation.

Example Response

{
  "Message": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}

Update CoworkerDeliveryUpdate an existing CoworkerDelivery record.

Create CoworkerDelivery

curl --request POST \
  --url https://spaces.nexudus.com/api/spaces/coworkerdeliveries \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>",
  "Location": "<string>",
  "DeliveryType": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/spaces/coworkerdeliveries"

payload = {
    "BusinessId": 123,
    "Name": "<string>",
    "Location": "<string>",
    "DeliveryType": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({BusinessId: 123, Name: '<string>', Location: '<string>', DeliveryType: 123})
};

fetch('https://spaces.nexudus.com/api/spaces/coworkerdeliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Enums

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400