Create Order with OANDA API on New Subscriber Added from ReferralHero API

Pipedream makes it easy to connect APIs for OANDA, ReferralHero and 2,500+ other apps remarkably fast.

Trigger workflow on

New Subscriber Added from the ReferralHero API

Next, do this

Create Order with the OANDA 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 ReferralHero trigger and OANDA action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Subscriber Added trigger
1. Connect your ReferralHero account
2. Configure timer
3. Select a List
Configure the Create Order action
1. Connect your OANDA account
2. Configure Is Demo
3. Select a Account ID
4. Select a Type
5. Optional- Select a Trade ID
6. Optional- Configure Instrument Name
7. Optional- Configure Units
8. Optional- Configure Price
9. Optional- Configure Distance
10. Optional- Select a Time in Force
11. Optional- Configure GTD Time
12. Optional- Configure Price Bound
13. Optional- Select a Position Fill
14. Optional- Select a Trigger Condition
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 Subscriber Added on ReferralHero

Description:Emit new event when a new subscriber is added

Version:0.0.1

Key:referralhero-new-subscriber-added

View on GitHub

ReferralHero Overview#

The ReferralHero API allows you to build custom referral marketing campaigns, manage participants, and track referral performance directly from Pipedream. You can automate participant registration, reward distribution, and integrate with other services for enhanced functionality like email marketing, CRM updates, or analytics. By leveraging Pipedream’s serverless platform, you can create workflows that react to events in ReferralHero, enrich referral data, or synchronize it with other apps.

Trigger Code#

import base from "../common/base.mjs";

export default {
  ...base,
  key: "referralhero-new-subscriber-added",
  name: "New Subscriber Added",
  description: "Emit new event when a new subscriber is added",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    ...base.props,
    listId: {
      propDefinition: [
        base.props.referralhero,
        "listId",
      ],
    },
  },
  methods: {
    ...base.methods,
    getResourceFn() {
      return this.referralhero.listSubscribers;
    },
    getArgs() {
      return {
        listId: this.listId,
        params: {
          sort_by: "registration_desc",
        },
      };
    },
    getResourceType() {
      return "subscribers";
    },
    generateMeta(subscriber) {
      return {
        id: subscriber.id,
        summary: `New Subscriber with ID ${subscriber.id}`,
        ts: subscriber.created_at,
      };
    },
  },
};

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
ReferralHero	`referralhero`	`app`	This component uses the ReferralHero app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
List	`listId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

About ReferralHero#

Everything you need to build, manage, and track a referral program‍... that doubles your business.

Action#

Create Order on OANDA

Description:Create a new trading order. [See the documentation](https://developer.oanda.com/rest-live-v20/order-ep/)

Version:0.0.1

Key:oanda-create-order

View on GitHub

OANDA Overview#

The OANDA API enables you to tap into the world of forex trading, providing real-time currency exchange rates, and the ability to automate trading strategies, manage accounts, access market data, and more. On Pipedream, you can craft workflows that capitalize on OANDA's capabilities, such as reacting to market changes, automating trades based on custom logic, and syncing forex data with other business applications for analysis and decision-making.

Action Code#

import oanda from "../../oanda.app.mjs";
import constants from "../../common/constants.mjs";

export default {
  key: "oanda-create-order",
  name: "Create Order",
  description: "Create a new trading order. [See the documentation](https://developer.oanda.com/rest-live-v20/order-ep/)",
  version: "0.0.1",
  type: "action",
  props: {
    oanda,
    isDemo: {
      propDefinition: [
        oanda,
        "isDemo",
      ],
    },
    accountId: {
      propDefinition: [
        oanda,
        "accountId",
        (c) => ({
          isDemo: c.isDemo,
        }),
      ],
    },
    type: {
      type: "string",
      label: "Type",
      description: "The type of the order to create",
      options: constants.ORDER_TYPES,
      reloadProps: true,
    },
    tradeID: {
      propDefinition: [
        oanda,
        "tradeId",
        (c) => ({
          isDemo: c.isDemo,
          accountId: c.accountId,
        }),
      ],
      optional: true,
      hidden: true,
    },
    instrument: {
      propDefinition: [
        oanda,
        "instrument",
      ],
      description: "The instrument for the order. E.g. `AUD_USD`",
      optional: true,
      hidden: true,
    },
    units: {
      type: "integer",
      label: "Units",
      description: "The quantity requested to be filled by the Order. A positive number of units results in a long Order, and a negative number of units results in a short Order.",
      optional: true,
      hidden: true,
    },
    price: {
      type: "string",
      label: "Price",
      description: "The price threshold specified for the Limit Order. The Order will only be filled by a market price that is equal to or better than this price.",
      optional: true,
      hidden: true,
    },
    distance: {
      type: "string",
      label: "Distance",
      description: "Specifies the distance (in price units) from the Account’s current price to use as the Stop Loss Order price. If the Trade is short the Instrument’s bid price is used, and for long Trades the ask is used",
      optional: true,
      hidden: true,
    },
    timeInForce: {
      type: "string",
      label: "Time in Force",
      description: "The time-in-force requested for the Order. Restricted to FOK or IOC for a MarketOrder.",
      options: constants.TIME_IN_FORCE_OPTIONS,
      optional: true,
      hidden: true,
    },
    gtdTime: {
      type: "string",
      label: "GTD Time",
      description: "The date/time when the Stop Order will be cancelled if its timeInForce is \"GTD\".",
      optional: true,
      hidden: true,
    },
    priceBound: {
      type: "string",
      label: "Price Bound",
      description: "The worst price that the client is willing to have the Order filled at",
      optional: true,
      hidden: true,
    },
    positionFill: {
      type: "string",
      label: "Position Fill",
      description: "Specification of how Positions in the Account are modified when the Order is filled",
      options: constants.POSITION_FILL_OPTIONS,
      optional: true,
      hidden: true,
    },
    triggerCondition: {
      type: "string",
      label: "Trigger Condition",
      description: "Specification of which price component should be used when determining if an Order should be triggered and filled",
      options: constants.ORDER_TRIGGER_CONDITIONS,
      optional: true,
      hidden: true,
    },
  },
  additionalProps(props) {
    if (!this.type) {
      return {};
    }
    const fields = constants.REQUIRED_FIELDS_FOR_ORDER_TYPES[this.type];
    for (const [
      key,
      value,
    ] of Object.entries(fields)) {
      props[key].hidden = false;
      props[key].optional = !value;
    }
    return {};
  },
  async run({ $ }) {
    const {
      oanda,
      isDemo,
      accountId,
      type,
      ...fields
    } = this;

    const response = await oanda.createOrder({
      $,
      isDemo,
      accountId,
      data: {
        order: {
          type,
          ...fields,
        },
      },
    });
    $.export("$summary", "Successfully created order");
    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
OANDA	`oanda`	`app`	This component uses the OANDA app.
Is Demo	`isDemo`	`boolean`	Set to `true` if using a demo/practice account
Account ID	`accountId`	`string`	Select a value from the drop down menu.
Type	`type`	`string`	Select a value from the drop down menu:`MARKETLIMITSTOPMARKET_IF_TOUCHEDTAKE_PROFITSTOP_LOSSGUARANTEED_STOP_LOSSTRAILING_STOP_LOSS`

Action Authentication#

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