> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sendoso.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Physical Gift

> This endpoint allows you to send a physical item directly to a recipient when their address is known.

### Body

<ParamField body="send" type="object" required>
  <Expandable title="send" defaultOpen="true">
    <ParamField body="touch_id" type="integer" required>
      The ID of the campaign within Sendoso you are wanting to send.
    </ParamField>

    <ParamField body="name" type="string" required>
      The recipient's name
    </ParamField>

    <ParamField body="email" type="string" required>
      The recipient's email address.
    </ParamField>

    <ParamField body="address" type="string" required>
      The recipient's street address.
    </ParamField>

    <ParamField body="city" type="string" required>
      The recipient's city.
    </ParamField>

    <ParamField body="state" type="string" required>
      The recipient's state.
    </ParamField>

    <ParamField body="zip" type="string" required>
      The recipient's zip/postal code.
    </ParamField>

    <ParamField body="country" type="string" required>
      The recipient's country.
    </ParamField>

    <ParamField body="mobile_no" type="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.
    </ParamField>

    <ParamField body="custom_message" type="string">
      The message that goes on the notecard in the gift box (if applicable).
    </ParamField>

    <ParamField body="confirm_address" type="boolean" required>
      Indicates if you are sending the address collection email. If are providing the recipient address, just send `false`.
    </ParamField>

    <ParamField body="via" type="string" required>
      Value must be `single_person_or_company`.
    </ParamField>

    <ParamField body="via_from" type="string" required>
      The name of the application making the send request. Please make sure this is consistent per application.
    </ParamField>
  </Expandable>
</ParamField>

### Response

<ResponseField name="success" type="boolean" required>
  Whether or not the request was successful. Always `true` for 2xx responses.
</ResponseField>

<ResponseField name="message" type="string" required>
  Response message.
</ResponseField>

<ResponseField name="tracking_code" type="string" required>
  The send's unique tracking code.
</ResponseField>

<RequestExample>
  ```json Example Request theme={null}
  {
    "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"
    }
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "success": true,
    "message": "Gift send Successfully",
    "tracking_code": "116d64dc686937dd17b1865019cee71d295bcf38"
  }
  ```

  ```json 400 - Bad Request theme={null}
  {
    "success": false,
    "message": "email can't be blank"
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "success": false,
    "message": "The access token is invalid"
  }
  ```

  ```json 404 - Not Found theme={null}
  {
    "success": false,
    "message": "Touch not found"
  }
  ```
</ResponseExample>