Physical Gifts
Send Physical Gift
This endpoint allows you to send a physical item directly to a recipient when their address is known.
POST
/
api
/
v3
/
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"
}
{
"success": false,
"message": "email can't be blank"
}
{
"success": false,
"message": "The access token is invalid"
}
{
"success": false,
"message": "Touch not found"
}
Body
object
required
Hide send
Hide send
integer
required
The ID of the campaign within Sendoso you are wanting to send.
string
required
The recipient’s name
string
required
The recipient’s email address.
string
required
The recipient’s street address.
string
required
The recipient’s city.
string
required
The recipient’s state.
string
required
The recipient’s zip/postal code.
string
required
The recipient’s country.
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.
string
The message that goes on the notecard in the gift box (if applicable).
boolean
required
Indicates if you are sending the address collection email. If are providing the recipient address, just send
false.string
required
Value must be
single_person_or_company.string
required
The name of the application making the send request. Please make sure this is consistent per application.
Response
boolean
required
Whether or not the request was successful. Always
true for 2xx responses.string
required
Response message.
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"
}
{
"success": false,
"message": "email can't be blank"
}
{
"success": false,
"message": "The access token is invalid"
}
{
"success": false,
"message": "Touch not found"
}
Previous
Send Physical Gift with Address CollectionThis endpoint allows you to send a physical item when you do not know the recipient address.
Next
⌘I
{
"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"
}
{
"success": false,
"message": "email can't be blank"
}
{
"success": false,
"message": "The access token is invalid"
}
{
"success": false,
"message": "Touch not found"
}