Send Physical Gift

POST

api

send

{
  "send": {
    "touch_id": 123456,
    "name": "John Smith",
    "email": "developers@sendoso.com",
    "address": "639 Front St, Floor 3",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94111",
    "country": "USA",
    "mobile_no": 1234567890,
    "custom_message": "Hi John, I wanted to personally invite you to...",
    "confirm_address": false,
    "via": "single_person_or_company",
    "via_from": "YOUR APPLICATION NAME"
  }
}

{
  "success": true,
  "message": "Gift send Successfully",
  "tracking_code": "116d64dc686937dd17b1865019cee71d295bcf38"
}

Body

send

object

required

touch_id

integer

required

The ID of the campaign within Sendoso you are wanting to send.

name

string

required

The recipient’s name

string

required

The recipient’s email address.

address

string

required

The recipient’s street address.

city

string

required

The recipient’s city.

state

string

required

The recipient’s state.

zip

string

required

The recipient’s zip/postal code.

country

string

required

The recipient’s country.

mobile_no

number

The recipient’s phone number. Required for non-US addresses - sending a request to this endpoint without this parameter will fail for any non-US address.

custom_message

string

The message that goes on the notecard in the gift box (if applicable).

confirm_address

boolean

required

Indicates if you are sending the address collection email. If are providing the recipient address, just send false.

via

string

required

Value must be single_person_or_company.

via_from

string

required

The name of the application making the send request. Please make sure this is consistent per application.

Response

success

boolean

required

Whether or not the request was successful. Always true for 2xx responses.

message

string

required

Response message.

tracking_code

string

required

The send’s unique tracking code.

{
  "send": {
    "touch_id": 123456,
    "name": "John Smith",
    "email": "developers@sendoso.com",
    "address": "639 Front St, Floor 3",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94111",
    "country": "USA",
    "mobile_no": 1234567890,
    "custom_message": "Hi John, I wanted to personally invite you to...",
    "confirm_address": false,
    "via": "single_person_or_company",
    "via_from": "YOUR APPLICATION NAME"
  }
}

{
  "success": true,
  "message": "Gift send Successfully",
  "tracking_code": "116d64dc686937dd17b1865019cee71d295bcf38"
}

Send Physical Gift with Address CollectionThis endpoint allows you to send a physical item when you do not know the recipient address.

{
  "send": {
    "touch_id": 123456,
    "name": "John Smith",
    "email": "developers@sendoso.com",
    "address": "639 Front St, Floor 3",
    "city": "San Francisco",
    "state": "CA",
    "zip": "94111",
    "country": "USA",
    "mobile_no": 1234567890,
    "custom_message": "Hi John, I wanted to personally invite you to...",
    "confirm_address": false,
    "via": "single_person_or_company",
    "via_from": "YOUR APPLICATION NAME"
  }
}

{
  "success": true,
  "message": "Gift send Successfully",
  "tracking_code": "116d64dc686937dd17b1865019cee71d295bcf38"
}

Getting Started

API Reference

Body

Response

Getting Started

API Reference

​Body

​Response

Body

Response