Calculate Shipping Rates with Printful API on New Announcement Read (Instant) from Guru API

Pipedream makes it easy to connect APIs for Printful, Guru and 3,000+ other apps remarkably fast.

Trigger workflow on

New Announcement Read (Instant) from the Guru API

Next, do this

Calculate Shipping Rates with the Printful 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 Guru trigger and Printful action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Announcement Read (Instant) trigger
1. Connect your Guru account
Configure the Calculate Shipping Rates action
1. Connect your Printful account
2. Select a Store ID
3. Configure Address 1
4. Configure City
5. Configure State Code
6. Configure Country Code
7. Configure ZIP/Postal Code
8. Optional- Configure Phone
9. Configure Items
10. Optional- Configure Currency
11. Optional- Select a Locale
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 Announcement Read (Instant) on Guru

Description:Emit new event when a user clicks on the "I read it" button in an Announcement. [See the documentation](https://developer.getguru.com/docs/creating-a-webhook)

Version:0.0.1

Key:guru-announcement-read-instant

View on GitHub

Guru Overview#

The Guru API on Pipedream enables the automation of knowledge sharing and management tasks within your team or organization. Using this API, you can programmatically interact with Guru's knowledge base, including retrieving card details, creating new cards, and updating existing content. By leveraging Pipedream's serverless platform, you can craft workflows that trigger based on events from other services, process the data, and perform actions in Guru to keep your team's knowledge up to date and accessible.

Trigger Code#

import common from "../common/base.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...common,
  key: "guru-announcement-read-instant",
  name: "New Announcement Read (Instant)",
  description: "Emit new event when a user clicks on the \"I read it\" button in an Announcement. [See the documentation](https://developer.getguru.com/docs/creating-a-webhook)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    getEventType() {
      return "alert-read";
    },
    getSummary(body) {
      return `Announcement Read: ${body.id}`;
    },
  },
  sampleEmit,
};

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
Guru	`guru`	`app`	This component uses the Guru app.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.

Trigger Authentication#

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

Guru requires their users enter their Guru login email in order to connect to their API.

To retrieve your API keys,

Navigate to your Guru account and sign in
Go to ”Team Settings” > “Apps and Integrations” > ”API Access”

About Guru#

Guru is reinventing knowledge sharing, providing verified information from experts on your team: where you work and when you need it most.

Action#

Calculate Shipping Rates on Printful

Description:Fetches available shipping rates for a given destination. [See the documentation](https://developers.printful.com/docs/#tag/Shipping-Rate-API/operation/calculateShippingRates)

Version:0.0.2

Key:printful-calculate-shipping-rates

View on GitHub

Printful Overview#

The Printful API unlocks the ability to automate custom print-on-demand operations within Pipedream's serverless platform. With this API, you can streamline the process of managing products, submitting orders, and syncing inventory. Building workflows around the Printful API on Pipedream can significantly reduce manual intervention, connect your e-commerce data with other services, and enhance customer experiences through timely fulfillment and updates.

Action Code#

import { LOCALE_OPTIONS } from "../../common/constants.mjs";
import { parseObject } from "../../common/utils.mjs";
import printful from "../../printful.app.mjs";

export default {
  key: "printful-calculate-shipping-rates",
  name: "Calculate Shipping Rates",
  description: "Fetches available shipping rates for a given destination. [See the documentation](https://developers.printful.com/docs/#tag/Shipping-Rate-API/operation/calculateShippingRates)",
  version: "0.0.2",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  type: "action",
  props: {
    printful,
    storeId: {
      propDefinition: [
        printful,
        "storeId",
      ],
    },
    address1: {
      label: "Address 1",
      description: "The address 1",
      type: "string",
    },
    city: {
      label: "City",
      description: "The city",
      type: "string",
    },
    stateCode: {
      label: "State Code",
      description: "The state code. E.g. `SC`",
      type: "string",
    },
    countryCode: {
      label: "Country Code",
      description: "The country code. E.g. `BR`",
      type: "string",
    },
    zip: {
      label: "ZIP/Postal Code",
      description: "The ZIP/postal code. E.g. `89221525`",
      type: "string",
    },
    phone: {
      label: "Phone",
      description: "The phone number",
      type: "string",
      optional: true,
    },
    items: {
      type: "string[]",
      label: "Items",
      description: "A list of items in JSON format. **Example: [{\"variant_id\": \"123456\", \"external_variant_id\": \"123456\", \"quantity\": 123, \"value\": \"12345\" }]**",
    },
    currency: {
      type: "string",
      label: "Currency",
      description: "3 letter currency code (optional), required if the rates need to be converted to another currency instead of store default currency",
      optional: true,
    },
    locale: {
      type: "string",
      label: "Locale",
      description: "Locale in which shipping rate names will be returned",
      options: LOCALE_OPTIONS,
      optional: true,
    },
  },
  async run({ $ }) {
    const shippingRates = await this.printful.fetchShippingRates({
      $,
      headers: {
        "X-PF-Store-Id": this.storeId,
      },
      data: {
        recipient: {
          address1: this.address1,
          city: this.city,
          state_code: this.stateCode,
          country_code: this.countryCode,
          zip: this.zip,
          phone: this.phone,
        },
        items: parseObject(this.items),
        currency: this.currency,
        locale: this.locale,
      },
    });
    $.export("$summary", "Fetched shipping rates successfully");
    return shippingRates;
  },
};

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
Printful	`printful`	`app`	This component uses the Printful app.
Store ID	`storeId`	`string`	Select a value from the drop down menu.
Address 1	`address1`	`string`	The address 1
City	`city`	`string`	The city
State Code	`stateCode`	`string`	The state code. E.g. `SC`
Country Code	`countryCode`	`string`	The country code. E.g. `BR`
ZIP/Postal Code	`zip`	`string`	The ZIP/postal code. E.g. `89221525`
Phone	`phone`	`string`	The phone number
Items	`items`	`string[]`	A list of items in JSON format. Example: [{"variant_id": "123456", "external_variant_id": "123456", "quantity": 123, "value": "12345" }]
Currency	`currency`	`string`	3 letter currency code (optional), required if the rates need to be converted to another currency instead of store default currency
Locale	`locale`	`string`	Select a value from the drop down menu:`{ "label": "English (US)", "value": "en_US" }{ "label": "Spanish (Spain)", "value": "es_ES" }`

Action Authentication#

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

Generate Printful API Token by on Printful Developer Page > Tokens > Add new Token.
Required scopes for the API Token:

View and manage orders of the authorized store
View and manage store products
View and manage store webhooks

Calculate Shipping Rates with Printful API on New Announcement Read (Instant) from Guru API

Pipedream makes it easy to connect APIs for Printful, Guru and 3,000+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of3,000+apps by most popular

1
-
24
of
3,000+
apps by most popular