Skip to content

SendOwl

The SendOwl modules allow you to watch, create, update, and delete the products, bundles, discounts, payments, and refunds in your SendOwl account.

Getting started with SendOwl

Prerequisites

  • A SendOwl account

In order to use SendOwl with Ibexa Connect, it is necessary to have a SendOwl account. If you do not have one, you can create a SendOwl account at sendowl.com/signup.

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting SendOwl to Ibexa Connect

To connect your SendOwl account to Ibexa Connect you need to obtain the API Key from your SendOwl account and insert it in the Create a connection dialog in the Ibexa Connect module.

  1. Log in to your SendOwl account.

  2. Click Settings > API.

    61d6b04131210.gif

  3. Click Add API Key.

  4. Enter a name for the API key, select the elements you want to access in your SendOwl account, and click Add API Key.

    61d6b0441a451.png

  5. Copy the API Key and the API secret to your clipboard.

    61d6b04544899.png

  6. Go to Ibexa Connect and open the SendOwl module's Create a connection dialog.

    61d6b046c9a8f.gif

  7. In the Connection name field, enter a name for the connection.

  8. In the API Key and API Secret fields, enter the API key and secret values copied in step 5 respectively.

The connection has been established.

Product

Create a Product

Creates a new product.

Name

Enter the name of the product.

Product Type

Select the product type:

  • Digital

  • Software

  • Redirect

  • Tangible

  • Service

  • Drip

Price

Enter the selling price of the product.

Self-hosted URL

Enter the URL address for downloading the software.

Sales Limit

Enter the number of products that can be sold.

License Type

Select the license type:

  • Generated

  • List

  • URL

License Fetch URL

Enter the URL address for the product license.

Shopify Variant ID

Enter the Variant ID of the Shopify item when using the SendOwl with Shopify.

Custom Field

If the custom field is enabled, then the values appear here.

Override Currency Code

Enter the currency code in which the product is being sold.

Price is Minimum

Select whether there is a minimum price for the product:

  • Yes

  • No

  • Not defined

Limit to Single Quantity in Cart

Select whether to limit a single quantity per sale:

  • Yes

  • No

  • Not defined

Affiliate Sellable

Select whether the product can be sold by affiliates:

  • Yes

  • No

  • Not defined

Download Folder

Enter the folder name where the product software is placed for downloading.

Commission Rate

Enter the commission rate for selling the product.

Weight

Enter the tangible product weight.

Get a Product

Returns a specified product.

Product Select the product whose details you want to retrieve.

Update a Product

Updates a product by ID.

Product

Select the product you want to update.

Name

Enter the name of the product.

Product Type

Select the product type:

  • Digital

  • Software

  • Redirect

  • Tangible

  • Service

  • Drip

Price

Enter the selling price of the product.

Self-hosted URL

Enter the URL address for downloading the software.

Sales Limit

Enter the number of products that can be sold.

License Type

Select the license type:

  • Generated

  • List

  • URL

License Fetch URL

Enter the URL address for the product license.

Shopify Variant

Enter the Variant ID of the Shopify item when using the SendOwl with Shopify.

Custom Field

If the custom field is enabled, then the values appear here.

Override Currency Code

Enter the currency code in which the product is being sold.

Price is Minimum

Select whether there is a minimum price for the product:

  • Yes

  • No

  • Not defined

Limit to Single Quantity in Cart

Select whether to limit single quantity per sale:

  • Yes

  • No

  • Not defined

Affiliate Sellable

Select whether the product can be sold by affiliates:

  • Yes

  • No

  • Not defined

Download Folder

Enter the folder name where the product software is placed for downloading.

Commission Rate

Enter the commission rate for selling the product.

Weight

Enter the tangible product weight.

Delete a Product

Deletes a product by ID.

Product Select the product you want to delete.

Bundle

Create a Bundle

Creates a new bundle.

Name Bundle

Enter the name of the bundle.

Price Bundle

Enter the selling price of the bundle.

Product IDs

Add the products for the bundle:

Value

Select the products to be added to the bundle.

Custom Field

If the custom field is enabled for the products, then the values appear here.

Shopify Variant ID

Enter the Variant ID of the Shopify item when using the SendOwl with Shopify.

Override Currency Code

Enter the currency code in which the product is being sold.

Limit to Single Quantity in Cart

Select whether to limit the single quantity per sale:

  • Yes

  • No

  • Not defined

Limit to Single quantity in cart

Select whether to limit a single quantity per sale:

  • Yes

  • No

  • Not defined

Affiliate Sellable

Select whether the product can be sold by affiliates:

  • Yes

  • No

  • Not defined

Commission Rate

Enter the commission rate for selling the Bundle. For example, 15%.

Get a Bundle

Returns a specified bundle by ID.

Bundle Select the bundle whose details you want to retrieve.

Update a Bundle

Updates a bundle by ID.

Bundle

Select the bundle you want to update.

Name Bundle

Enter the name of the bundle.

Price Bundle

Enter the selling price of the bundle.

Product IDs

Add the products for the bundle:

Value

Select the products to be added to the bundle.

Custom Field

If the custom field is enabled for the products, then the values appear here.

Shopify Variant ID

Enter the Variant ID of the Shopify item when using the SendOwl with Shopify.

Override Currency Code

Enter the currency code in which the product is being sold.

Limit to single quantity in cart

Select whether to limit single quantity per sale:

  • Yes

  • No

  • Not defined

Limit to single quantity in cart

Select whether to limit single quantity per sale:

  • Yes

  • No

  • Not defined

Affiliate Sellable

Select whether the bundle can be sold by affiliates:

  • Yes

  • No

  • Not defined

Commission Rate

Enter the commission rate for selling the Bundle. For example, 15%.

Delete a Bundle

Deletes a bundle by ID.

Bundle Select the bundle you want to delete.

Discount

Create a Discount

Creates a new discount.

Name Enter the name of the discount.
Usage Limit Enter the total number of time discount can be used.
Minimum Cart Value Enter the minimum cart value to be eligible for the discount to be applied.
Fixed Discount Enter the amount for the fixed discount. For example, 8.
Codes Enter the discount code to use for availing of the discount.
Override Currency Code Enter the currency code applicable for the discount. Use ISO 4217 standards.
Expires at Enter the date and time when the discount expires or ends.
Percentage Discount Enter the discount in percentage. For example, 5%.

Get a Discount

Returns a specified discount.

Discount Select the discount whose details you want to retrieve.

Update a Discount

Updates a discount by ID.

Discount Select the discount you want to update.
Name Enter the name of the discount.
Usage Limit Enter the total number of time discount can be used.
Minimum cart value Enter the minimum cart value to be eligible for the discount to be applied.
Fixed Discount Enter the amount for the fixed discount. For example, 8.
Codes Enter the discount code to use for availing of the discount.
Override currency code Enter the currency code applicable for the discount. Use ISO 4217 standards.
Expires at Enter the date and time when the discount expires or ends.
Percentage Discount Enter the discount in percentage. For example, 5%.

Delete a Discount

Deletes a discount by ID.

Discount Select the discount you want to delete.

Other

Watch New Payment

Triggers when a new payment is made to order in SendOwl.

Webhook Name Enter a name for the webhook.

See the Connecting to a SendOwl Webhook using Ibexa Connect for adding the webhook in SendOwl.

Watch Order Completed

Triggers when an order has been completed.

Webhook Name Enter a name for the webhook.

See the Connecting to a SendOwl Webhook using Ibexa Connect for adding the webhook in SendOwl.

Watch New Subscription

Triggers when a subscription order reaches complete or canceled state in SendOwl.

Webhook Name Enter a name for the webhook.

See the Connecting to a SendOwl Webhook using Ibexa Connect for adding the webhook in SendOwl.

Watch New Refund

Triggers when a refund is issued.

Webhook Name Enter a name for the webhook.

See the Connecting to a SendOwl Webhook using Ibexa Connect for adding the webhook in SendOwl.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://www.sendowl.com/api. For example: /v1/packages

For the list of available endpoints, refer to the SendOwl API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Products

The following API call returns all the products from your SendOwl account:

Get

/v1/products

Method

GET

61d6b0497f54f.png

Matches of the search can be found in the module's Output under Bundle \> Body. In our example, 2 products were returned:

61d6b04ac2c80.png

Connecting to a SendOwl Webhook using Ibexa Connect

1. Open any Webhook module and enter the details as mentioned in the respective module description and click Save. Copy the link to your clipboard.

2. Login to your SendOwl account.

3. Click Settings > Web Hooks.

61d6b04c34a72.gif

4. Click Add a Web Hook and the details and click Create.

Name

Enter a webhook name

State

Select whether the webhook is enabled:

  • Enabled

  • Disabled

URL

Enter the URL address copied in step 1.

Event

Select the events for which you want to receive the triggers.

Conditions

Select the conditions for which you want to receive the triggers.

The webhook is successfully added. the details as mentioned in the respective module description and click Save. Copy the link to your clipboard.

2. Login to your SendOwl account.

3. Click Settings > Web Hooks.

61d6b04c34a72.gif

4. Click Add a Web Hook and the details and click Create.

Name

Enter a webhook name

State

Select whether the webhook is enabled:

  • Enabled

  • Disabled

URL

Enter the URL address copied in step 1.

Event

Select the events for which you want to receive the triggers.

Conditions

Select the conditions for which you want to receive the triggers.

The webhook is successfully added.