Enable Connect Orders & Text Alerts

How Shout Connect Orders and Text Alerts Work

With many affiliate and independent distributor business models, it can be difficult to standardize simple tasks such as sending text and shipping alerts without providing a confusing experience for customers. Shout Connect overcomes these challenges by sending these alerts from the affiliate or sales team member's Shout account, ensuring that the affiliate becomes the customer's single point of contact for reorders, support, and fulfillment information. Shout Connect allows you to send affiliates a notification and create orders in their account when a customer places an order. The managed Shout account then delivers the text alerts and followups directly to the customer from the affiliate's account.

Before You Get Started

If you've skipped over the preceding Shout guides ( no worries, we don't always read everything first either 😉), here are a few things that you'll want do before you open up your code and enable Connect Orders and Text Alerts:

1. Make sure you or your organization has Shout Connect enabled on their account. If you're not sure, login to your Shout account and navigate to Settings > Services > Shout Connect. If you aren't able to access the Shout Connect page, reach out to Shout support (for production environments) or Shout Developers (for development environments) and ask to have it enabled for your organization first.
2. Check out our guide for setting up a development environment for easy testing and troubleshooting. You'll need api credentials.
3. Make sure that you have at least one other shout account that has authorized your Shout Connect account. You can read more about this in the Shout Connect Overview.

Step-By-Step Enabling Connect Orders and Text Alerts

There are four steps to enabling Connect Orders and Text Alerts. These steps are explained in detail with code examples below.

1. Add an order to a connected account when an order is placed
2. (Optional) Notify the connected account that an order has been added
3. (Optional) Backfill historical orders you'd like affiliates or distributors to have reference information for
4. (Optional) Customize the plugin and simple connect page to provide default Order Alert text message to send and allow affiliates and distributors to enable order alerts with the integration

Step 1: Add an order to a connected account when an order is placed

When a customer places an order with your organization, the first step to sending them a text alert from an affiliate or distributor is to add the order details to the affiliate's connected Shout account. Shout Connect makes this very simple and straight forward:

1. Construct the payload for the Order Create api call.
2. Include the X-Shout-Connect-ID OR X-Shout-User-Id special headers along with the API credentials header in your call. Check out the documentation here for more information.
3. Post to the Orders Create endpoint.

{
  "order": {
    "invoiced_at": "now",
    "paid_at": "now",
    "description": "Order from Ecommerce Site",
    "profile_name": "Janet Smith",
    "profile_phone_number": "(801) 555-6788",
    "profile_shipping_address_raw": "1 E Center St, Provo, UT 84606",
    "line_items": [
      {
        "name": "Tank Top",
        "each_price_cents": 3500,
        "quantity": 2,
        "price_cents": 7000
      },
      {
        "name": "T-Shirt",
        "each_price_cents": 4900,
        "quantity": 1,
        "price_cents": 4900
      }
    ],
    "total_cents": 16800,
    "fail_if_connect_orders_not_enabled": true
  }
}

curl https://www.shout.app/api/v20210901/orders -X POST \
-u username:password \
-d "{\"order\":{\"invoiced_at\":\"now\",\"paid_at\":\"now\",\"description\":\"Order from Ecommerce Site\",\"profile_name\":\"Janet Smith\",\"profile_phone_number\":\"(801) 555-6788\",\"profile_shipping_address_raw\":\"1 E Center St, Provo, UT 84606\",\"line_items\":[{\"name\":\"Tank Top\",\"each_price_cents\":3500,\"quantity\":2,\"price_cents\":7000},{\"name\":\"T-Shirt\",\"each_price_cents\":4900,\"quantity\":1,\"price_cents\":4900}],\"total_cents\":16800,\"fail_if_connect_orders_not_enabled\":true}}"

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://www.shout.app/api/v20210901/orders")
uri.query = {"order":{"invoiced_at":"now","paid_at":"now","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true}}
request = Net::HTTP::Post.new(uri)
request.basic_auth("username", "password")
request.body = JSON.dump({"order":{"invoiced_at":"now","paid_at":"now","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true}})

req_options = { use_ssl: uri.scheme == "https" }

response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(request)
end

# response.code
# response.body

import requests
from requests.structures import CaseInsensitiveDict

url = "https://www.shout.app/api/v20210901/orders"

headers = {
  "Content-Type": "application/json",
}
data = '{"order":{"invoiced_at":"now","paid_at":"now","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true}}'

response = requests.post(url, headers=headers, data=data, auth=('username', 'password'))

print(response.status_code)

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://www.shout.app/api/v20210901/orders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"order\":{\"invoiced_at\":\"now\",\"paid_at\":\"now\",\"description\":\"Order from Ecommerce Site\",\"profile_name\":\"Janet Smith\",\"profile_phone_number\":\"(801) 555-6788\",\"profile_shipping_address_raw\":\"1 E Center St, Provo, UT 84606\",\"line_items\":[{\"name\":\"Tank Top\",\"each_price_cents\":3500,\"quantity\":2,\"price_cents\":7000},{\"name\":\"T-Shirt\",\"each_price_cents\":4900,\"quantity\":1,\"price_cents\":4900}],\"total_cents\":16800,\"fail_if_connect_orders_not_enabled\":true}}");

$headers = array();
$headers[] = 'Content-Type: application/x-www-form-urlencoded';
curl_setopt($ch, CURLOPT_USERPWD, 'username' . ':' . 'password');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
  echo 'Error:' . curl_error($ch);
}
curl_close($ch);

import javax.xml.bind.DatatypeConverter;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;

class Main {

  public static void main(String[] args) throws IOException {
    URL url = new URL("https://www.shout.app/api/v20210901/orders");
    HttpURLConnection httpConn = (HttpURLConnection) url.openConnection();
    httpConn.setRequestMethod("POST");

    byte[] message = ("username:password").getBytes("UTF-8");
    String basicAuth = DatatypeConverter.printBase64Binary(message);
    httpConn.setRequestProperty("Authorization", "Basic " + basicAuth);

    httpConn.setDoOutput(true);
    OutputStreamWriter writer = new OutputStreamWriter(httpConn.getOutputStream());
    writer.write("{\"order\":{\"invoiced_at\":\"now\",\"paid_at\":\"now\",\"description\":\"Order from Ecommerce Site\",\"profile_name\":\"Janet Smith\",\"profile_phone_number\":\"(801) 555-6788\",\"profile_shipping_address_raw\":\"1 E Center St, Provo, UT 84606\",\"line_items\":[{\"name\":\"Tank Top\",\"each_price_cents\":3500,\"quantity\":2,\"price_cents\":7000},{\"name\":\"T-Shirt\",\"each_price_cents\":4900,\"quantity\":1,\"price_cents\":4900}],\"total_cents\":16800,\"fail_if_connect_orders_not_enabled\":true}}");
    writer.flush();
    writer.close();
    httpConn.getOutputStream().close();

    InputStream responseStream = httpConn.getResponseCode() / 100 == 2
        ? httpConn.getInputStream()
        : httpConn.getErrorStream();
    Scanner s = new Scanner(responseStream).useDelimiter("\A");
    String response = s.hasNext() ? s.next() : "";
    System.out.println(response);
  }
}

var request = require('request');

var headers = {
};

var dataString = '{"order":{"invoiced_at":"now","paid_at":"now","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true}}';

var options = {
    url: 'https://www.shout.app/api/v20210901/orders',
    method: 'POST',
    headers: headers,
    body: dataString,
    auth: {
        'user': 'username',
        'pass': 'password'
    }
};

function callback(error, response, body) {
    if (!error && response.statusCode == 200) {
        console.log(body);
    }
}

request(options, callback);

package main

import (
  "fmt"
  "io/ioutil"
  "log"
  "net/http"
  "strings"
)

func main() {
  client := &http.Client{}
  var data = strings.NewReader(`{"order":{"invoiced_at":"now","paid_at":"now","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true}}`)
  req, err := http.NewRequest("POST", "https://www.shout.app/api/v20210901/orders", data)
  if err != nil {
    log.Fatal(err)
  }
  req.SetBasicAuth("username", "password")
  resp, err := client.Do(req)
  if err != nil {
    log.Fatal(err)
  }
  defer resp.Body.Close()
  bodyText, err := ioutil.ReadAll(resp.Body)
  if err != nil {
    log.Fatal(err)
  }
  fmt.Printf("%s\n", bodyText)
}

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("POST"), "https://www.shout.app/api/v20210901/orders"))
    {
        var base64authorization = Convert.ToBase64String(Encoding.ASCII.GetBytes("username:password"));
        request.Headers.TryAddWithoutValidation("Authorization", $"Basic {base64authorization}"); 


        request.Content = new StringContent({"order":{"invoiced_at":"now","paid_at":"now","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true}});
        request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/x-www-form-urlencoded");

        var response = await httpClient.SendAsync(request);
    }
}

{
  "id": 234868,
  "company_id": 8109,
  "created_at": "2023-06-21T22:06:02.799121-06:00",
  "description": "Order from Ecommerce Site",
  "dont_trigger_auto_actions": false,
  "integration": "connect",
  "invoiced_at": "2023-06-21T22:06:02.775344-06:00",
  "invoiced_source": "connect",
  "line_items": [
    {
      "each_price": "$35.00",
      "each_price_cents": 3500,
      "each_price_currency": "USD",
      "name": "Tank Top",
      "object": "order_line_item",
      "price": "$70.00",
      "price_cents": 7000,
      "price_currency": "USD",
      "quantity": 2.0
    },
    {
      "each_price": "$49.00",
      "each_price_cents": 4900,
      "each_price_currency": "USD",
      "name": "T-Shirt",
      "object": "order_line_item",
      "price": "$49.00",
      "price_cents": 4900,
      "price_currency": "USD",
      "quantity": 1.0
    }
  ],
  "metadata": null,
  "notified_profile_of_paid_invoice_at": null,
  "object": "order",
  "paid_at": "2023-06-21T22:06:02.775368-06:00",
  "paid_source": "connect",
  "profile_email": null,
  "profile_id": 6645902,
  "profile_name": "Janet Smith",
  "profile_phone_number": "+18015556788",
  "profile_shipping_address_raw": "1 E Center St, Provo, UT 84606",
  "reference_id": null,
  "refunded_at": null,
  "refunded_source": null,
  "shipped_at": null,
  "shipped_source": null,
  "status": "paid",
  "total": "$168.00",
  "total_cents": 16800,
  "total_currency": "USD",
  "updated_at": "2023-06-21T22:06:02.799121-06:00"
}

Step 2: Notify the connected account that an order has been added

Although optional, it's best practice to notify affiliates and distributors that you've added an order to their account. This ensures that they are aware that alerts will be sent (if they have them enabled) and allows them to be prepared to handle support and fulfillment questions. Shout Connect makes sending this notificaiton very simple. You'll simply post a message to the /messages/send_connect_notification with the connect_id or shout user_id. Here's a simple example:

1. Construct the payload for the Send Shout Notification api call.
2. Include the API credentials header in your call. Check out the documentation here for more information.
3. Post to the Send Connect Notification or Send Broadcast Message endpoint.

{
  "message": {
    "body": "A new order has been added to your account.",
    "user_id": 315
  }
}

curl https://www.shout.app/api/v20230615/messages/send_connect_notification -X POST \
-u username:password \
-d "{\"message\":{\"body\":\"A new order has been added to your account.\",\"user_id\":315}}"

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://www.shout.app/api/v20230615/messages/send_connect_notification")
uri.query = {"message":{"body":"A new order has been added to your account.","user_id":315}}
request = Net::HTTP::Post.new(uri)
request.basic_auth("username", "password")
request.body = JSON.dump({"message":{"body":"A new order has been added to your account.","user_id":315}})

req_options = { use_ssl: uri.scheme == "https" }

response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(request)
end

# response.code
# response.body

import requests
from requests.structures import CaseInsensitiveDict

url = "https://www.shout.app/api/v20230615/messages/send_connect_notification"

headers = {
  "Content-Type": "application/json",
}
data = '{"message":{"body":"A new order has been added to your account.","user_id":315}}'

response = requests.post(url, headers=headers, data=data, auth=('username', 'password'))

print(response.status_code)

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://www.shout.app/api/v20230615/messages/send_connect_notification');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"message\":{\"body\":\"A new order has been added to your account.\",\"user_id\":315}}");

$headers = array();
$headers[] = 'Content-Type: application/x-www-form-urlencoded';
curl_setopt($ch, CURLOPT_USERPWD, 'username' . ':' . 'password');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
  echo 'Error:' . curl_error($ch);
}
curl_close($ch);

import javax.xml.bind.DatatypeConverter;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;

class Main {

  public static void main(String[] args) throws IOException {
    URL url = new URL("https://www.shout.app/api/v20230615/messages/send_connect_notification");
    HttpURLConnection httpConn = (HttpURLConnection) url.openConnection();
    httpConn.setRequestMethod("POST");

    byte[] message = ("username:password").getBytes("UTF-8");
    String basicAuth = DatatypeConverter.printBase64Binary(message);
    httpConn.setRequestProperty("Authorization", "Basic " + basicAuth);

    httpConn.setDoOutput(true);
    OutputStreamWriter writer = new OutputStreamWriter(httpConn.getOutputStream());
    writer.write("{\"message\":{\"body\":\"A new order has been added to your account.\",\"user_id\":315}}");
    writer.flush();
    writer.close();
    httpConn.getOutputStream().close();

    InputStream responseStream = httpConn.getResponseCode() / 100 == 2
        ? httpConn.getInputStream()
        : httpConn.getErrorStream();
    Scanner s = new Scanner(responseStream).useDelimiter("\A");
    String response = s.hasNext() ? s.next() : "";
    System.out.println(response);
  }
}

var request = require('request');

var headers = {
};

var dataString = '{"message":{"body":"A new order has been added to your account.","user_id":315}}';

var options = {
    url: 'https://www.shout.app/api/v20230615/messages/send_connect_notification',
    method: 'POST',
    headers: headers,
    body: dataString,
    auth: {
        'user': 'username',
        'pass': 'password'
    }
};

function callback(error, response, body) {
    if (!error && response.statusCode == 200) {
        console.log(body);
    }
}

request(options, callback);

package main

import (
  "fmt"
  "io/ioutil"
  "log"
  "net/http"
  "strings"
)

func main() {
  client := &http.Client{}
  var data = strings.NewReader(`{"message":{"body":"A new order has been added to your account.","user_id":315}}`)
  req, err := http.NewRequest("POST", "https://www.shout.app/api/v20230615/messages/send_connect_notification", data)
  if err != nil {
    log.Fatal(err)
  }
  req.SetBasicAuth("username", "password")
  resp, err := client.Do(req)
  if err != nil {
    log.Fatal(err)
  }
  defer resp.Body.Close()
  bodyText, err := ioutil.ReadAll(resp.Body)
  if err != nil {
    log.Fatal(err)
  }
  fmt.Printf("%s\n", bodyText)
}

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("POST"), "https://www.shout.app/api/v20230615/messages/send_connect_notification"))
    {
        var base64authorization = Convert.ToBase64String(Encoding.ASCII.GetBytes("username:password"));
        request.Headers.TryAddWithoutValidation("Authorization", $"Basic {base64authorization}"); 


        request.Content = new StringContent({"message":{"body":"A new order has been added to your account.","user_id":315}});
        request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/x-www-form-urlencoded");

        var response = await httpClient.SendAsync(request);
    }
}

{
  "id": 13330,
  "body": "A new order has been added to your account.",
  "company_id": 6,
  "conversation_id": 3910,
  "created_at": "2023-06-22T14:52:36.274303-06:00",
  "deleted_at": null,
  "dont_mark_as_open": null,
  "favorite": false,
  "favorited_at": null,
  "object": "message",
  "profile_id": null,
  "send_at": null,
  "updated_at": "2023-06-22T14:52:36.274303-06:00"
}

Step 3: Backfill Historical Orders

Although optional, it's very helpful to add historical orders to connected accounts so that affiliates and distributors can easily identify loyal customers and repeat purchases. This also makes it easier for them to handle support and fulfillment questions and improve their marketing and followups. Shout Connect makes backfilling historical orders very simple. You'll simply create an order just as you did in Step 1 above with an additional parameter in the payload of dont_trigger_auto_actions so that the order doesn't send out real time text alerts. Here's an example:

1. Construct the payload for the Order Create api call.
2. Include the X-Shout-Connect-ID OR X-Shout-User-Id special headers along with the API credentials header in your call. Check out the documentation here for more information.
3. Post to the Orders Create endpoint.

{
  "order": {
    "created_at": "2021-04-09T12:00:00.123456-06:00",
    "invoiced_at": "2023-01-03",
    "paid_at": "2023-01-03",
    "description": "Order from Ecommerce Site",
    "profile_name": "Janet Smith",
    "profile_phone_number": "(801) 555-6788",
    "profile_shipping_address_raw": "1 E Center St, Provo, UT 84606",
    "line_items": [
      {
        "name": "Tank Top",
        "each_price_cents": 3500,
        "quantity": 2,
        "price_cents": 7000
      },
      {
        "name": "T-Shirt",
        "each_price_cents": 4900,
        "quantity": 1,
        "price_cents": 4900
      }
    ],
    "total_cents": 16800,
    "fail_if_connect_orders_not_enabled": true,
    "dont_trigger_auto_actions": true
  }
}

curl https://www.shout.app/api/v20210901/orders -X POST \
-u username:password \
-d "{\"order\":{\"created_at\":\"2021-04-09T12:00:00.123456-06:00\",\"invoiced_at\":\"2023-01-03\",\"paid_at\":\"2023-01-03\",\"description\":\"Order from Ecommerce Site\",\"profile_name\":\"Janet Smith\",\"profile_phone_number\":\"(801) 555-6788\",\"profile_shipping_address_raw\":\"1 E Center St, Provo, UT 84606\",\"line_items\":[{\"name\":\"Tank Top\",\"each_price_cents\":3500,\"quantity\":2,\"price_cents\":7000},{\"name\":\"T-Shirt\",\"each_price_cents\":4900,\"quantity\":1,\"price_cents\":4900}],\"total_cents\":16800,\"fail_if_connect_orders_not_enabled\":true,\"dont_trigger_auto_actions\":true}}"

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://www.shout.app/api/v20210901/orders")
uri.query = {"order":{"created_at":"2021-04-09T12:00:00.123456-06:00","invoiced_at":"2023-01-03","paid_at":"2023-01-03","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true,"dont_trigger_auto_actions":true}}
request = Net::HTTP::Post.new(uri)
request.basic_auth("username", "password")
request.body = JSON.dump({"order":{"created_at":"2021-04-09T12:00:00.123456-06:00","invoiced_at":"2023-01-03","paid_at":"2023-01-03","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true,"dont_trigger_auto_actions":true}})

req_options = { use_ssl: uri.scheme == "https" }

response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(request)
end

# response.code
# response.body

import requests
from requests.structures import CaseInsensitiveDict

url = "https://www.shout.app/api/v20210901/orders"

headers = {
  "Content-Type": "application/json",
}
data = '{"order":{"created_at":"2021-04-09T12:00:00.123456-06:00","invoiced_at":"2023-01-03","paid_at":"2023-01-03","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true,"dont_trigger_auto_actions":true}}'

response = requests.post(url, headers=headers, data=data, auth=('username', 'password'))

print(response.status_code)

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://www.shout.app/api/v20210901/orders');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);

curl_setopt($ch, CURLOPT_POSTFIELDS, "{\"order\":{\"created_at\":\"2021-04-09T12:00:00.123456-06:00\",\"invoiced_at\":\"2023-01-03\",\"paid_at\":\"2023-01-03\",\"description\":\"Order from Ecommerce Site\",\"profile_name\":\"Janet Smith\",\"profile_phone_number\":\"(801) 555-6788\",\"profile_shipping_address_raw\":\"1 E Center St, Provo, UT 84606\",\"line_items\":[{\"name\":\"Tank Top\",\"each_price_cents\":3500,\"quantity\":2,\"price_cents\":7000},{\"name\":\"T-Shirt\",\"each_price_cents\":4900,\"quantity\":1,\"price_cents\":4900}],\"total_cents\":16800,\"fail_if_connect_orders_not_enabled\":true,\"dont_trigger_auto_actions\":true}}");

$headers = array();
$headers[] = 'Content-Type: application/x-www-form-urlencoded';
curl_setopt($ch, CURLOPT_USERPWD, 'username' . ':' . 'password');
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
  echo 'Error:' . curl_error($ch);
}
curl_close($ch);

import javax.xml.bind.DatatypeConverter;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;

class Main {

  public static void main(String[] args) throws IOException {
    URL url = new URL("https://www.shout.app/api/v20210901/orders");
    HttpURLConnection httpConn = (HttpURLConnection) url.openConnection();
    httpConn.setRequestMethod("POST");

    byte[] message = ("username:password").getBytes("UTF-8");
    String basicAuth = DatatypeConverter.printBase64Binary(message);
    httpConn.setRequestProperty("Authorization", "Basic " + basicAuth);

    httpConn.setDoOutput(true);
    OutputStreamWriter writer = new OutputStreamWriter(httpConn.getOutputStream());
    writer.write("{\"order\":{\"created_at\":\"2021-04-09T12:00:00.123456-06:00\",\"invoiced_at\":\"2023-01-03\",\"paid_at\":\"2023-01-03\",\"description\":\"Order from Ecommerce Site\",\"profile_name\":\"Janet Smith\",\"profile_phone_number\":\"(801) 555-6788\",\"profile_shipping_address_raw\":\"1 E Center St, Provo, UT 84606\",\"line_items\":[{\"name\":\"Tank Top\",\"each_price_cents\":3500,\"quantity\":2,\"price_cents\":7000},{\"name\":\"T-Shirt\",\"each_price_cents\":4900,\"quantity\":1,\"price_cents\":4900}],\"total_cents\":16800,\"fail_if_connect_orders_not_enabled\":true,\"dont_trigger_auto_actions\":true}}");
    writer.flush();
    writer.close();
    httpConn.getOutputStream().close();

    InputStream responseStream = httpConn.getResponseCode() / 100 == 2
        ? httpConn.getInputStream()
        : httpConn.getErrorStream();
    Scanner s = new Scanner(responseStream).useDelimiter("\A");
    String response = s.hasNext() ? s.next() : "";
    System.out.println(response);
  }
}

var request = require('request');

var headers = {
};

var dataString = '{"order":{"created_at":"2021-04-09T12:00:00.123456-06:00","invoiced_at":"2023-01-03","paid_at":"2023-01-03","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true,"dont_trigger_auto_actions":true}}';

var options = {
    url: 'https://www.shout.app/api/v20210901/orders',
    method: 'POST',
    headers: headers,
    body: dataString,
    auth: {
        'user': 'username',
        'pass': 'password'
    }
};

function callback(error, response, body) {
    if (!error && response.statusCode == 200) {
        console.log(body);
    }
}

request(options, callback);

package main

import (
  "fmt"
  "io/ioutil"
  "log"
  "net/http"
  "strings"
)

func main() {
  client := &http.Client{}
  var data = strings.NewReader(`{"order":{"created_at":"2021-04-09T12:00:00.123456-06:00","invoiced_at":"2023-01-03","paid_at":"2023-01-03","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true,"dont_trigger_auto_actions":true}}`)
  req, err := http.NewRequest("POST", "https://www.shout.app/api/v20210901/orders", data)
  if err != nil {
    log.Fatal(err)
  }
  req.SetBasicAuth("username", "password")
  resp, err := client.Do(req)
  if err != nil {
    log.Fatal(err)
  }
  defer resp.Body.Close()
  bodyText, err := ioutil.ReadAll(resp.Body)
  if err != nil {
    log.Fatal(err)
  }
  fmt.Printf("%s\n", bodyText)
}

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("POST"), "https://www.shout.app/api/v20210901/orders"))
    {
        var base64authorization = Convert.ToBase64String(Encoding.ASCII.GetBytes("username:password"));
        request.Headers.TryAddWithoutValidation("Authorization", $"Basic {base64authorization}"); 


        request.Content = new StringContent({"order":{"created_at":"2021-04-09T12:00:00.123456-06:00","invoiced_at":"2023-01-03","paid_at":"2023-01-03","description":"Order from Ecommerce Site","profile_name":"Janet Smith","profile_phone_number":"(801) 555-6788","profile_shipping_address_raw":"1 E Center St, Provo, UT 84606","line_items":[{"name":"Tank Top","each_price_cents":3500,"quantity":2,"price_cents":7000},{"name":"T-Shirt","each_price_cents":4900,"quantity":1,"price_cents":4900}],"total_cents":16800,"fail_if_connect_orders_not_enabled":true,"dont_trigger_auto_actions":true}});
        request.Content.Headers.ContentType = MediaTypeHeaderValue.Parse("application/x-www-form-urlencoded");

        var response = await httpClient.SendAsync(request);
    }
}

Step 4: Customize the default order alert text and enable the feature in your Connect Plugin and Simple Connect Page

Most new affiliates and distributors will take some time to become familiar with your products and their business tools, so it's best practice to customize the default order text alert that their Shout account will use when they enable the Connect Account integration. Shout makes it easy to customize this default Order Text alert:

1. Login to your Shout account and navigate to your Shout Connect services Page by clicking on Settings > Services > Shout Connect. If the page is not visible contact Shout support to have it enabled on your account.
2. Click the "Manage" button and then click Edit to open the settings modal
3. Click the "Text Orders to Customers Tab" switch to the "On" position
   
4. Scroll down and edit the "Order paid template" and click "Save"