Skip to main content
POST
Create a return shipment intent
Key: Write Scope: Company

Authorizations

Authorization
string
header
required

Use your Primo API key in the Authorization header as Bearer <API_KEY>.

Body

application/json
offboardingId
string
required

The offboarding this step belongs to, from getOffboardings

Pattern: ^[a-f\d]{24}$
fromAddress
object | null

Where the parcel is picked up, by default the leaver's address

toAddress
object | null

Where it goes, by default the company's first address

createBoxShipment
boolean | null

Send a Primo box to the leaver first

parcel
object | null
hasInsurance
boolean | null
value
integer | null

Declared value of the content, in cents: 150000 for €1,500

Required range: 0 < x <= 9007199254740991
content
object[] | null

What goes back; replaced whole

billingProfileId
string | null

From getBillingProfiles

Pattern: ^[a-f\d]{24}$
notificationEmails
string[] | null
Minimum string length: 1
comment
string | null
parentTicketId
string | null

The ticket to hold the task. Defaults to the offboarding ticket; never a typed task.

Pattern: ^[a-f\d]{24}$

Response

default - application/json
id
string
required

Intent id, to pass to its update and execute tools

taskId
string | null
required

The typed task that tracks this step

ticketId
string | null
required

The ticket holding that task, usually the offboarding ticket. Null if it could not be read back.

offboardingId
string
required
executedAt
string<date-time> | null
required

When the intent executed; null until then

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
fromAddress
object | null
required
toAddress
object | null
required
createBoxShipment
boolean
required
parcel
object | null
required
hasInsurance
boolean
required
value
number | null
required

Declared value, in cents

content
object[]
required
billingProfileId
string | null
required
notificationEmails
string[]
required
comment
string | null
required
shipmentId
string | null
required

The shipment created on execute, to read with getShipment