Mail Postcard with DocuPost API on New Row Added from Supabase API

Pipedream makes it easy to connect APIs for DocuPost, Supabase and 2,400+ other apps remarkably fast.

Trigger workflow on

New Row Added from the Supabase API

Next, do this

Mail Postcard with the DocuPost API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Supabase trigger and DocuPost action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Row Added trigger
1. Connect your Supabase account
2. Configure Table
3. Optional- Configure Row Identifier
4. Optional- Configure Column
5. Optional- Select a Filter
6. Optional- Configure Value
7. Configure Order By
8. Optional- Select a Sort Order
9. Configure timer
Configure the Mail Postcard action
1. Connect your DocuPost account
2. Configure Front Image URL
3. Configure Back Image URL
4. Configure Recipient's Name
5. Configure Recipient's Address Line 1
6. Optional- Configure Recipient's Address Line 2
7. Configure Recipient's City
8. Select a Recipient's State
9. Configure Recipient's Postal Code
10. Configure Sender's Name
11. Configure Sender's Address Line 1
12. Optional- Configure Sender's Address Line 2
13. Configure Sender's City
14. Select a Sender's State
15. Configure Sender's Postal Code
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Row Added on Supabase

Description:Emit new event for every new row added in a table. [See documentation here](https://supabase.com/docs/reference/javascript/select)

Version:0.0.4

Key:supabase-new-row-added

View on GitHub

Supabase Overview#

Supabase is a real-time backend-as-a-service that provides developers with a suite of tools to quickly build and scale their applications. It offers database storage, authentication, instant APIs, and real-time subscriptions. With the Supabase API, you can perform CRUD operations on your database, manage users, and listen to database changes in real time. When integrated with Pipedream, you can automate workflows that react to these database events, synchronize data across multiple services, or streamline user management processes.

Trigger Code#

import base from "../common/base.mjs";
import {
  DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
  ConfigurationError,
} from "@pipedream/platform";
import constants from "../../common/constants.mjs";

export default {
  key: "supabase-new-row-added",
  name: "New Row Added",
  description: "Emit new event for every new row added in a table. [See documentation here](https://supabase.com/docs/reference/javascript/select)",
  version: "0.0.4",
  type: "source",
  props: {
    ...base.props,
    column: {
      propDefinition: [
        base.props.supabase,
        "column",
      ],
      optional: true,
    },
    filter: {
      propDefinition: [
        base.props.supabase,
        "filter",
      ],
      optional: true,
    },
    value: {
      propDefinition: [
        base.props.supabase,
        "value",
      ],
      optional: true,
    },
    orderBy: {
      propDefinition: [
        base.props.supabase,
        "column",
      ],
      label: "Order By",
      description: "Column name to order by",
    },
    sortOrder: {
      propDefinition: [
        base.props.supabase,
        "sortOrder",
      ],
    },
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  methods: {
    _getOffset() {
      return this.db.get("offset") || 0;
    },
    _setOffset(offset) {
      this.db.set("offset", offset);
    },
  },
  async run() {
    const {
      table,
      column,
      filter,
      value,
      orderBy,
      sortOrder,
      rowIdentifier,
    } = this;

    if ((column || filter || value) && !(column && filter && value)) {
      throw new ConfigurationError("If `column`, `filter`, or `value` is used, all three must be entered");
    }

    const offset = this._getOffset();
    const client = await this.supabase._client();
    const query = client
      .from(table)
      .select()
      .order(orderBy, {
        ascending: sortOrder,
      })
      .range(offset, offset + constants.MAX_OFFSET);

    if (filter) {
      const filterMethod = this.supabase[filter];
      filterMethod(query, column, value);
    }

    const { data } = await query;
    this._setOffset(offset + data.length);

    for (const row of data) {
      let summary = "New row in table";
      if (row[rowIdentifier]) {
        summary = `${summary}: ${row[rowIdentifier]}`;
      }
      this.$emit(row, {
        summary,
      });
    }
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Supabase	`supabase`	`app`	This component uses the Supabase app.
Table	`table`	`string`	The name of the table to watch for new rows
Row Identifier	`rowIdentifier`	`string`	The column name to use as the row identifier
Column	`column`	`string`	Column name to search by
Filter	`filter`	`string`	Select a value from the drop down menu:`{ "label": "Equal", "value": "equalTo" }{ "label": "Not Equal", "value": "notEqualTo" }{ "label": "Greater Than", "value": "greaterThan" }{ "label": "Greater Than or Equal To", "value": "greaterThanOrEqualTo" }{ "label": "Less Than", "value": "lessThan" }{ "label": "Less Than or Equal To", "value": "lessThanOrEqualTo" }{ "label": "Contains (Case Sensitive)", "value": "patternMatch" }{ "label": "Contains (Case Insensitive)", "value": "patternMatchCaseInsensitive" }`
Value	`value`	`string`	Value of the column specified to search for
Order By	`orderBy`	`string`	Column name to order by
Sort Order	`sortOrder`	`string`	Select a value from the drop down menu:`ascendingdescending`
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

Supabase uses API keys for authentication. When you connect your Supabase account, Pipedream securely stores the keys so you can easily authenticate to Supabase APIs in both code and no-code steps.

Supabase provides a Service Key to get started. You can find the service_role in the API Settings page.

Finding the Supabase subdomain

About Supabase#

Supabase is an open source Firebase alternative.

Action#

Mail Postcard on DocuPost

Description:Dispatches a glossy, color 4x6 postcard via the US Postal Service. [See the documentation](https://help.docupost.com/help/send-postcard-api)

Version:0.0.1

Key:docupost-mail-postcard

View on GitHub

DocuPost Overview#

The DocuPost API enables automated mail handling, offering services like sending letters, postcards, and checks via a programmatic interface. Within Pipedream, you can harness this API to create dynamic, serverless workflows that trigger postal mail actions based on various events from a plethora of supported apps. Think of automating thank-you notes, payment disbursements, or direct mail marketing campaigns, all reacting in real-time to user behavior, payment events, or custom triggers.

Action Code#

import app from "../../docupost.app.mjs";

export default {
  key: "docupost-mail-postcard",
  name: "Mail Postcard",
  description: "Dispatches a glossy, color 4x6 postcard via the US Postal Service. [See the documentation](https://help.docupost.com/help/send-postcard-api)",
  version: "0.0.1",
  type: "action",
  props: {
    app,
    frontImage: {
      type: "string",
      label: "Front Image URL",
      description: "A valid image URL for the front of your postcard. Image should be 1875 x 1275. PNG recommended. Your API request will succeed but your mailing will later fail if the image is the incorrect size.",
    },
    backImage: {
      type: "string",
      label: "Back Image URL",
      description: "A valid image URL for the back of your postcard. Image should be 1875 x 1275. PNG recommended. Your API request will succeed but your mailing will later fail if the image is the incorrect size. Important: Your recipient/sender and postage information will be automatically overlaid onto your image. See [this template](https://docupost.s3.us-east-2.amazonaws.com/postcardtemplateback_ip0jws.png) as an example. ",
    },
    toName: {
      propDefinition: [
        app,
        "toName",
      ],
    },
    toAddress1: {
      propDefinition: [
        app,
        "toAddress1",
      ],
    },
    toAddress2: {
      propDefinition: [
        app,
        "toAddress2",
      ],
    },
    toCity: {
      propDefinition: [
        app,
        "toCity",
      ],
    },
    toState: {
      propDefinition: [
        app,
        "toState",
      ],
    },
    toZip: {
      propDefinition: [
        app,
        "toZip",
      ],
    },
    fromName: {
      propDefinition: [
        app,
        "fromName",
      ],
    },
    fromAddress1: {
      propDefinition: [
        app,
        "fromAddress1",
      ],
    },
    fromAddress2: {
      propDefinition: [
        app,
        "fromAddress2",
      ],
    },
    fromCity: {
      propDefinition: [
        app,
        "fromCity",
      ],
    },
    fromState: {
      propDefinition: [
        app,
        "fromState",
      ],
    },
    fromZip: {
      propDefinition: [
        app,
        "fromZip",
      ],
    },
  },
  methods: {
    sendPostcard(args = {}) {
      return this.app.post({
        path: "/sendpostcard",
        ...args,
      });
    },
  },
  async run({ $ }) {
    const {
      sendPostcard,
      frontImage,
      backImage,
      toName,
      toAddress1,
      toAddress2,
      toCity,
      toState,
      toZip,
      fromName,
      fromAddress1,
      fromAddress2,
      fromCity,
      fromState,
      fromZip,
    } = this;

    const response = await sendPostcard({
      $,
      params: {
        front_image: frontImage,
        back_image: backImage,
        to_name: toName,
        to_address1: toAddress1,
        to_address2: toAddress2,
        to_city: toCity,
        to_state: toState,
        to_zip: toZip,
        from_name: fromName,
        from_address1: fromAddress1,
        from_address2: fromAddress2,
        from_city: fromCity,
        from_state: fromState,
        from_zip: fromZip,
      },
    });

    $.export("$summary", "Successfully sent postcard");
    return response;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
DocuPost	`app`	`app`	This component uses the DocuPost app.
Front Image URL	`frontImage`	`string`	A valid image URL for the front of your postcard. Image should be 1875 x 1275. PNG recommended. Your API request will succeed but your mailing will later fail if the image is the incorrect size.
Back Image URL	`backImage`	`string`	A valid image URL for the back of your postcard. Image should be 1875 x 1275. PNG recommended. Your API request will succeed but your mailing will later fail if the image is the incorrect size. Important: Your recipient/sender and postage information will be automatically overlaid onto your image. See this template as an example.
Recipient's Name	`toName`	`string`	The name of the recipient (who the letter/postcard is being sent to). Must be less than 40 characters.
Recipient's Address Line 1	`toAddress1`	`string`	The first line of the recipient's address.
Recipient's Address Line 2	`toAddress2`	`string`	The second line of the recipient's address.
Recipient's City	`toCity`	`string`	The city of the recipient.
Recipient's State	`toState`	`string`	Select a value from the drop down menu:`{ "label": "Alabama", "value": "AL" }{ "label": "Alaska", "value": "AK" }{ "label": "American Samoa", "value": "AS" }{ "label": "Arizona", "value": "AZ" }{ "label": "Arkansas", "value": "AR" }{ "label": "California", "value": "CA" }{ "label": "Colorado", "value": "CO" }{ "label": "Connecticut", "value": "CT" }{ "label": "Delaware", "value": "DE" }{ "label": "District of Columbia", "value": "DC" }{ "label": "Federated States of Micronesia", "value": "FM" }{ "label": "Florida", "value": "FL" }{ "label": "Georgia", "value": "GA" }{ "label": "Guam", "value": "GU" }{ "label": "Hawaii", "value": "HI" }{ "label": "Idaho", "value": "ID" }{ "label": "Illinois", "value": "IL" }{ "label": "Indiana", "value": "IN" }{ "label": "Iowa", "value": "IA" }{ "label": "Kansas", "value": "KS" }{ "label": "Kentucky", "value": "KY" }{ "label": "Louisiana", "value": "LA" }{ "label": "Maine", "value": "ME" }{ "label": "Marshall Islands", "value": "MH" }{ "label": "Maryland", "value": "MD" }{ "label": "Massachusetts", "value": "MA" }{ "label": "Michigan", "value": "MI" }{ "label": "Minnesota", "value": "MN" }{ "label": "Mississippi", "value": "MS" }{ "label": "Missouri", "value": "MO" }{ "label": "Montana", "value": "MT" }{ "label": "Nebraska", "value": "NE" }{ "label": "Nevada", "value": "NV" }{ "label": "New Hampshire", "value": "NH" }{ "label": "New Jersey", "value": "NJ" }{ "label": "New Mexico", "value": "NM" }{ "label": "New York", "value": "NY" }{ "label": "North Carolina", "value": "NC" }{ "label": "North Dakota", "value": "ND" }{ "label": "Northern Mariana Islands", "value": "MP" }{ "label": "Ohio", "value": "OH" }{ "label": "Oklahoma", "value": "OK" }{ "label": "Oregon", "value": "OR" }{ "label": "Palau", "value": "PW" }{ "label": "Pennsylvania", "value": "PA" }{ "label": "Puerto Rico", "value": "PR" }{ "label": "Rhode Island", "value": "RI" }{ "label": "South Carolina", "value": "SC" }{ "label": "South Dakota", "value": "SD" }{ "label": "Tennessee", "value": "TN" }{ "label": "Texas", "value": "TX" }{ "label": "Utah", "value": "UT" }{ "label": "Vermont", "value": "VT" }{ "label": "Virgin Islands", "value": "VI" }{ "label": "Virginia", "value": "VA" }{ "label": "Washington", "value": "WA" }{ "label": "West Virginia", "value": "WV" }{ "label": "Wisconsin", "value": "WI" }{ "label": "Wyoming", "value": "WY" }{ "label": "Armed Forces Europe, the Middle East, and Canada", "value": "AE" }{ "label": "Armed Forces Pacific", "value": "AP" }{ "label": "Armed Forces Americas (except Canada)", "value": "AA" }{ "label": "North", "value": "N" }{ "label": "East", "value": "E" }{ "label": "South", "value": "S" }{ "label": "West", "value": "W" }{ "label": "Northeast", "value": "NE" }{ "label": "Southeast", "value": "SE" }{ "label": "Northwest", "value": "NW" }{ "label": "Southwest", "value": "SW" }`
Recipient's Postal Code	`toZip`	`string`	The 5-digit postal code for the recipient.
Sender's Name	`fromName`	`string`	Your sender/return address name. Must be less than 40 characters.
Sender's Address Line 1	`fromAddress1`	`string`	The first line of your sender/return address.
Sender's Address Line 2	`fromAddress2`	`string`	The second line of your sender/return address.
Sender's City	`fromCity`	`string`	The city of your sender/return address.
Sender's State	`fromState`	`string`	Select a value from the drop down menu:`{ "label": "Alabama", "value": "AL" }{ "label": "Alaska", "value": "AK" }{ "label": "American Samoa", "value": "AS" }{ "label": "Arizona", "value": "AZ" }{ "label": "Arkansas", "value": "AR" }{ "label": "California", "value": "CA" }{ "label": "Colorado", "value": "CO" }{ "label": "Connecticut", "value": "CT" }{ "label": "Delaware", "value": "DE" }{ "label": "District of Columbia", "value": "DC" }{ "label": "Federated States of Micronesia", "value": "FM" }{ "label": "Florida", "value": "FL" }{ "label": "Georgia", "value": "GA" }{ "label": "Guam", "value": "GU" }{ "label": "Hawaii", "value": "HI" }{ "label": "Idaho", "value": "ID" }{ "label": "Illinois", "value": "IL" }{ "label": "Indiana", "value": "IN" }{ "label": "Iowa", "value": "IA" }{ "label": "Kansas", "value": "KS" }{ "label": "Kentucky", "value": "KY" }{ "label": "Louisiana", "value": "LA" }{ "label": "Maine", "value": "ME" }{ "label": "Marshall Islands", "value": "MH" }{ "label": "Maryland", "value": "MD" }{ "label": "Massachusetts", "value": "MA" }{ "label": "Michigan", "value": "MI" }{ "label": "Minnesota", "value": "MN" }{ "label": "Mississippi", "value": "MS" }{ "label": "Missouri", "value": "MO" }{ "label": "Montana", "value": "MT" }{ "label": "Nebraska", "value": "NE" }{ "label": "Nevada", "value": "NV" }{ "label": "New Hampshire", "value": "NH" }{ "label": "New Jersey", "value": "NJ" }{ "label": "New Mexico", "value": "NM" }{ "label": "New York", "value": "NY" }{ "label": "North Carolina", "value": "NC" }{ "label": "North Dakota", "value": "ND" }{ "label": "Northern Mariana Islands", "value": "MP" }{ "label": "Ohio", "value": "OH" }{ "label": "Oklahoma", "value": "OK" }{ "label": "Oregon", "value": "OR" }{ "label": "Palau", "value": "PW" }{ "label": "Pennsylvania", "value": "PA" }{ "label": "Puerto Rico", "value": "PR" }{ "label": "Rhode Island", "value": "RI" }{ "label": "South Carolina", "value": "SC" }{ "label": "South Dakota", "value": "SD" }{ "label": "Tennessee", "value": "TN" }{ "label": "Texas", "value": "TX" }{ "label": "Utah", "value": "UT" }{ "label": "Vermont", "value": "VT" }{ "label": "Virgin Islands", "value": "VI" }{ "label": "Virginia", "value": "VA" }{ "label": "Washington", "value": "WA" }{ "label": "West Virginia", "value": "WV" }{ "label": "Wisconsin", "value": "WI" }{ "label": "Wyoming", "value": "WY" }{ "label": "Armed Forces Europe, the Middle East, and Canada", "value": "AE" }{ "label": "Armed Forces Pacific", "value": "AP" }{ "label": "Armed Forces Americas (except Canada)", "value": "AA" }{ "label": "North", "value": "N" }{ "label": "East", "value": "E" }{ "label": "South", "value": "S" }{ "label": "West", "value": "W" }{ "label": "Northeast", "value": "NE" }{ "label": "Southeast", "value": "SE" }{ "label": "Northwest", "value": "NW" }{ "label": "Southwest", "value": "SW" }`
Sender's Postal Code	`fromZip`	`string`	The 5-digit postal code for your sender/return address.

Action Authentication#

DocuPost uses API keys for authentication. When you connect your DocuPost account, Pipedream securely stores the keys so you can easily authenticate to DocuPost APIs in both code and no-code steps.

About DocuPost#

Mail letters and postcards online. We’ll print, stamp and send U.S. mail for you, from 95¢. Simple, pay-as-you-go pricing.

More Ways to Connect DocuPost + Supabase#

Other Popular Integrations#

Mail Letter with DocuPost API on New Row Added from Supabase API

Supabase + DocuPost

Try it

Mail Letter with DocuPost API on New Webhook Event (Instant) from Supabase API

Supabase + DocuPost

Try it

Mail Postcard with DocuPost API on New Webhook Event (Instant) from Supabase API

Supabase + DocuPost

Try it

Popular Triggers#

New Row Added from the Supabase API

Emit new event for every new row added in a table. See documentation here

Try it

New Webhook Event (Instant) from the Supabase API

Emit new event for every insert, update, or delete operation in a table. This source requires user configuration using the Supabase website. More information in the README. Also see documentation here

Try it