Create Issue with GitHub API on Low Category Balance from You Need a Budget API

Pipedream makes it easy to connect APIs for GitHub, You Need a Budget and 2,000+ other apps remarkably fast.

Trigger workflow on

Low Category Balance from the You Need a Budget API

Next, do this

Create Issue with the GitHub API

No credit card required

▶

Watch us build a workflow

4 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

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

Select this integration
Configure the Low Category Balance trigger
1. Connect your You Need a Budget account
2. Configure timer
3. Select a Budget ID
4. Select a Category ID
5. Configure Amount
Configure the Create Issue action
1. Connect your GitHub account
2. Select a Repository
3. Configure Title
4. Optional- Configure Body
5. Optional- Select one or more Labels
6. Optional- Select one or more Assignees
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#

Low Category Balance on You Need a Budget

Description:Emit new event when a category balance drops below a certain amount

Version:0.0.4

Key:you_need_a_budget-low-category-balance

View on GitHub

You Need a Budget Overview#

The You Need a Budget (YNAB) API offers a direct line into your budgeting data, allowing you to read and write transaction details, access budget categories, update account balances, and more. By leveraging this API on Pipedream, you can automate your financial tracking and synchronize your budget with other aspects of your financial life. This interface is particularly powerful for those looking to streamline their budgeting process, ensure real-time updates across platforms, and generate custom financial reports.

Trigger Code#

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

export default {
  ...common,
  key: "you_need_a_budget-low-category-balance",
  // eslint-disable-next-line pipedream/source-name
  name: "Low Category Balance",
  description: "Emit new event when a category balance drops below a certain amount",
  version: "0.0.4",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    categoryId: {
      propDefinition: [
        common.props.app,
        "categoryId",
        (c) => ({
          budgetId: c.budgetId,
        }),
      ],
    },
    amount: {
      propDefinition: [
        common.props.app,
        "amount",
      ],
    },
  },
  methods: {
    ...common.methods,
    generateMeta(balance, amount) {
      return {
        id: balance,
        summary: `Balance (${balance}) for ${this.getThisMonth()} dropped below ${amount}`,
      };
    },
  },
  async run() {
    const { category } = await this.app.getCategoryBudget({
      budgetId: this.budgetId,
      categoryId: this.categoryId.value,
    });

    // guarantee correct value is used
    const amount = this.app.convertFromMilliunit(this.app._convertToMilliunit(this.amount));
    const balance = this.app.convertFromMilliunit(category.balance);

    if (balance < amount) {
      const meta = this.generateMeta(balance, amount);
      this.$emit(category, meta);
    }
  },
};

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
You Need a Budget	`app`	`app`	This component uses the You Need a Budget app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Budget ID	`budgetId`	`string`	Select a value from the drop down menu.
Category ID	`categoryId`	`string`	Select a value from the drop down menu.
Amount	`amount`	`string`	E.g. `-290.99`

Trigger Authentication#

You Need a Budget uses OAuth authentication. When you connect your You Need a Budget account, Pipedream will open a popup window where you can sign into You Need a Budget and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any You Need a Budget API.

Pipedream requests the following authorization scopes when you connect your account:

About You Need a Budget#

Money doesn’t have to be messy. The YNAB budgeting app and its simple four-rule method will help you organize your finances, demolish your debt, save piles of cash, and reach your financial goals faster.

Action#

Create Issue on GitHub

Description:Create a new issue in a Gihub repo. [See docs here](https://docs.github.com/en/rest/issues/issues#create-an-issue)

Version:0.2.14

Key:github-create-issue

View on GitHub

GitHub Overview#

The GitHub API is a powerful gateway to interaction with GitHub's vast web of data and services, offering a suite of endpoints to manipulate and retrieve information on repositories, pull requests, issues, and more. Harnessing this API on Pipedream, you can orchestrate automated workflows that respond to events in real-time, manage repository data, streamline collaborative processes, and connect GitHub with other services for a more integrated development lifecycle.

Action Code#

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

export default {
  key: "github-create-issue",
  name: "Create Issue",
  description: "Create a new issue in a Gihub repo. [See docs here](https://docs.github.com/en/rest/issues/issues#create-an-issue)",
  version: "0.2.14",
  type: "action",
  props: {
    github,
    repoFullname: {
      propDefinition: [
        github,
        "repoFullname",
      ],
    },
    title: {
      label: "Title",
      description: "The title of the issue",
      type: "string",
    },
    body: {
      label: "Body",
      description: "The contents of the issue",
      type: "string",
      optional: true,
    },
    labels: {
      label: "Labels",
      description: "Labels to associate with this issue. NOTE: Only users with push access can set labels for new issues",
      optional: true,
      propDefinition: [
        github,
        "labels",
        (c) => ({
          repoFullname: c.repoFullname,
        }),
      ],
    },
    assignees: {
      label: "Assignees",
      description: "Logins for Users to assign to this issue. NOTE: Only users with push access can set assignees for new issues",
      optional: true,
      propDefinition: [
        github,
        "collaborators",
        (c) => ({
          repoFullname: c.repoFullname,
        }),
      ],
    },
  },
  async run({ $ }) {
    const response = await this.github.createIssue({
      repoFullname: this.repoFullname,
      data: {
        title: this.title,
        body: this.body,
        labels: this.labels,
        assignees: this.assignees,
      },
    });

    $.export("$summary", "Successfully created issue.");

    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
GitHub	`github`	`app`	This component uses the GitHub app.
Repository	`repoFullname`	`string`	Select a value from the drop down menu.
Title	`title`	`string`	The title of the issue
Body	`body`	`string`	The contents of the issue
Labels	`labels`	`string[]`	Select a value from the drop down menu.
Assignees	`assignees`	`string[]`	Select a value from the drop down menu.

Action Authentication#

GitHub uses OAuth authentication. When you connect your GitHub account, Pipedream will open a popup window where you can sign into GitHub and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any GitHub API.

Pipedream requests the following authorization scopes when you connect your account:

repoadmin:orgadmin:public_keyadmin:org_hookgistprojectnotificationsuserwrite:discussionwrite:packagesread:packagesadmin:repo_hook

Create Issue with GitHub API on Low Category Balance from You Need a Budget API

Pipedream makes it easy to connect APIs for GitHub, You Need a Budget and 2,000+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,000+apps by most popular

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