> ## 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.

# About the iFrame

> With the Sendoso iFrame we handle the sending & user experience; you display it.

Embedding the Sendoso iFrame enables your user to use the power of Sendoso without leaving your own application. You can use the iFrame integration to:

* embed Sendoso into their internal CRM
* embed Sendoso into a channel partner application
* communicate with Sendoso outside of the <a href="https://app.sendoso.com">Sendoso application</a>

This can include a messaging application (see our <a href="https://sendoso.zendesk.com/hc/en-us/articles/115000814091-Outreach-io-Integration">Outreach use case</a>) as well as a custom integration housed directly on your internal CRM like for example our [SalesLoft integration](https://sendoso.zendesk.com/hc/en-us/articles/115000872071-SalesLoft-Integration).

# Using the Sendoso iFrame

## Enable the iFrame Connection

To leverage the Sendoso iFrame, please email <a href="developers@sendoso.com">[developers@sendoso.com](mailto:developers@sendoso.com)</a> with a summary of your use case and the URL for your application.  Our team will work with you to authorize and host Sendoso iFrame within your application.

## Set up the Sendoso iFrame

1. Enable the Sendoso icon within your application/portal and create its associated iFrame link
2. Enable the Sendoso iFrame within your platform
3. Input required to send
   * Sender Information
   * Recipient Information
   * Delivery Location
     * For electronic gifts
       * Recipient Email
     * For physical gifts
       * Recipient Name
       * Street
       * City
       * State
       * Country
       * Postal Code (If applicable)

## iFrame Reference

* iFrame URL: [https://app.sendoso.com/v2/plugin/sends](https://app.sendoso.com/v2/plugin/sends)

* Setup URL(POST) Example: [https://app.sendoso.com/\{\{Custom}}/setup](https://app.sendoso.com/\{\{Custom}}/setup)

* iFrame Dimensions: width 435 px, height 500 px

* Sendoso icon: <a href="https://drive.google.com/file/d/1vGQ8fQy7A0w5ZEYjfvclaWrrItRs_yzU/view">download the icon</a>

The iFrame endpoint also supports optional URL parameters to prepopulate the recipient information within the send flow. A list of the URL parameters along with a description of each is below. All special characters must be HTML encoded.

<table>
  <th>URL Param</th>
  <th>Description</th>
  <tr><td>name</td>
  <td>The recipient's full name</td></tr>
  <tr><td>email</td>
  <td>The recipient's email address</td></tr>
  <tr><td>address1</td>
  <td>The recipient's street address</td></tr>
  <tr><td>address2</td>
  <td>The recipient's extended address (e.g., apartment or suite)</td></tr>
  <tr><td>State</td>
  <td>The recipient's state</td></tr>
  <tr><td>zip</td>
  <td>The recipient's postal code</td></tr>
  <tr><td>country</td>
  <td>The recipient's country</td></tr>
</table>

Example usage: [https://app.sendoso.com/v2/plugin/sends?email=\{email\_address}](https://app.sendoso.com/v2/plugin/sends?email=\{email_address})