← Microsoft Teams + Retriever integrations

Create Device Return with Retriever API on New Channel from Microsoft Teams API

Pipedream makes it easy to connect APIs for Retriever, Microsoft Teams and 2,400+ other apps remarkably fast.

Trigger workflow on
New Channel from the Microsoft Teams API
Next, do this
Create Device Return with the Retriever API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
8 min
Watch now ➜

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

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

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

  1. Select this integration
  2. Configure the New Channel trigger
    1. Connect your Microsoft Teams account
    2. Configure Polling interval
    3. Select a Team
  3. Configure the Create Device Return action
    1. Connect your Retriever account
    2. Configure Request Charger
    3. Optional- Configure Employee Info Email
    4. Configure Employee Info Name
    5. Configure Employee Info Address Line 1
    6. Optional- Configure Employee Info Address Line 2
    7. Optional- Configure Employee Info Address City
    8. Optional- Configure Employee Info Address State
    9. Optional- Configure Employee Info Address Zip
    10. Configure Company Info Return Recipient Name
    11. Optional- Configure Company Info Return Address Company
    12. Configure Company Info Return Address Line 1
    13. Optional- Configure Company Info Return Address Line 2
    14. Optional- Configure Company Info Return Address City
    15. Optional- Configure Company Info Return Address State
    16. Optional- Configure Company Info Return Address Zip
    17. Configure Company Info Display Name
    18. Optional- Configure Company Info Notification Email
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. 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

Description:Emit new event when a new channel is created within a team
Version:0.0.7
Key:microsoft_teams-new-channel

Microsoft Teams Overview

The Microsoft Teams API on Pipedream allows you to automate tasks, streamline communication, and integrate with other services to enhance the functionality of Teams as a collaboration hub. With this API, you can send messages to channels, orchestrate complex workflows based on Teams events, and manage Teams' settings programmatically.

Trigger Code

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

export default {
  ...base,
  key: "microsoft_teams-new-channel",
  name: "New Channel",
  description: "Emit new event when a new channel is created within a team",
  version: "0.0.7",
  type: "source",
  dedupe: "unique",
  props: {
    ...base.props,
    team: {
      propDefinition: [
        base.props.microsoftTeams,
        "team",
      ],
    },
  },
  methods: {
    ...base.methods,
    async getResources(lastCreated) {
      return this.getNewPaginatedResources(
        this.microsoftTeams.listChannels,
        {
          teamId: this.team,
        },
        lastCreated,
      );
    },
    generateMeta(channel) {
      return {
        id: channel.id,
        summary: channel.displayName,
        ts: Date.parse(channel.createdDateTime),
      };
    },
  },
};

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.
LabelPropTypeDescription
Microsoft TeamsmicrosoftTeamsappThis component uses the Microsoft Teams app.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
Polling intervaltimer$.interface.timer

Pipedream will poll the YouTube API on this schedule

TeamteamstringSelect a value from the drop down menu.

Trigger Authentication

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

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

User.Reademailoffline_accessopenidprofileChat.ReadChat.ReadWriteChatMessage.SendChannel.ReadBasic.AllChannelMessage.SendTeam.ReadBasic.AllSchedule.Read.All

About Microsoft Teams

Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.

Action

Description:Creates a device return order. [See the documentation](https://app.helloretriever.com/api/v1/docs/#tag/Device-Return-Orders/operation/Submit%20Order)
Version:0.0.1
Key:retriever-create-device-return

Retriever Overview

The Retriever API is designed for automating contact information retrieval, enriching your CRM data, or building lead generation tools. By integrating it with Pipedream, you can strategically extract valuable data and automate workflows for marketing, sales, or customer support. Pipedream’s serverless platform enables you to connect Retriever with hundreds of other apps, triggering actions based on new data, or updating systems in real-time.

Action Code

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

export default {
  key: "retriever-create-device-return",
  name: "Create Device Return",
  description: "Creates a device return order. [See the documentation](https://app.helloretriever.com/api/v1/docs/#tag/Device-Return-Orders/operation/Submit%20Order)",
  type: "action",
  version: "0.0.1",
  props: {
    app,
    requestCharger: {
      type: "boolean",
      label: "Request Charger",
      description: "Whether or not to request a charger with the device return.",
    },
    employeeInfoEmail: {
      type: "string",
      label: "Employee Info Email",
      description: "Optional email address for notifying the employee when a box ships and is delivered, as well as sending reminders.",
      optional: true,
    },
    employeeInfoName: {
      type: "string",
      label: "Employee Info Name",
      description: "The employee name to print on the shipping label.",
    },
    employeeInfoAddressLine1: {
      type: "string",
      label: "Employee Info Address Line 1",
      description: "The first line of the employee's address (typically the street address), or a full, comma-separated address. If providing the *Employee Info Address Line 1*, *Employee Info Address City*, *Employee Info Address State*, and *Employee Info Address Zip* are required (*Employee Info Address Line 2* remains optional). If providing a full address, it is best to use the format `1 Main St, New York, NY 10001` or `1 Main St, Apt 200, New York, NY 10001`. We will attempt to parse any full address, but cannot guarantee accuracy - especially if other formats are used. It is highly recommended to provide the address in separate fields.",
    },
    employeeInfoAddressLine2: {
      type: "string",
      label: "Employee Info Address Line 2",
      description: "Optional second line of the employee's address.",
      optional: true,
    },
    employeeInfoAddressCity: {
      type: "string",
      label: "Employee Info Address City",
      description: "Optional if a full address is provided in *Employee Info Address Line 1*. Required otherwise.",
      optional: true,
    },
    employeeInfoAddressState: {
      type: "string",
      label: "Employee Info Address State",
      description: "Optional if a full address is provided in *Employee Info Address Line 1*. Required otherwise.",
      optional: true,
    },
    employeeInfoAddressZip: {
      type: "string",
      label: "Employee Info Address Zip",
      description: "Optional if a full address is provided in *Employee Info Address Line 1*. Required otherwise.",
      optional: true,
    },
    companyInfoReturnRecipientName: {
      type: "string",
      label: "Company Info Return Recipient Name",
      description: "The return recipient name to print on the shipping label.",
    },
    companyInfoReturnAddressCompany: {
      type: "string",
      label: "Company Info Return Address Company",
      description: "The return recipient company to print on the shipping label.",
      optional: true,
    },
    companyInfoReturnAddressLine1: {
      type: "string",
      label: "Company Info Return Address Line 1",
      description: "The first line of the return address (typically the street address), or a full, comma-separated address. If providing the *Company Info Return Address Line 1*, *Company Info Return Address City*, *Company Info Return Address State*, and *Company Info Return Address  Zip* are required (*Company Info Return Address Line 2* remains optional). If providing a full address, it is best to use the format `1 Main St, New York, NY 10001` or `1 Main St, Apt 200, New York, NY 10001`. We will attempt to parse any full address, but cannot guarantee accuracy - especially if other formats are used. It is highly recommended to provide the address in separate fields.",
    },
    companyInfoReturnAddressLine2: {
      type: "string",
      label: "Company Info Return Address Line 2",
      description: "Optional second line of the return address.",
      optional: true,
    },
    companyInfoReturnAddressCity: {
      type: "string",
      label: "Company Info Return Address City",
      description: "Optional if a full address is provided in *Company Info Return Address Line 1*. Required otherwise.",
      optional: true,
    },
    companyInfoReturnAddressState: {
      type: "string",
      label: "Company Info Return Address State",
      description: "Optional if a full address is provided in *Company Info Return Address Line 1*. Required otherwise.",
      optional: true,
    },
    companyInfoReturnAddressZip: {
      type: "string",
      label: "Company Info Return Address Zip",
      description: "Optional if a full address is provided in *Company Info Return Address Line 1*. Required otherwise.",
      optional: true,
    },
    companyInfoDisplayName: {
      type: "string",
      label: "Company Info Display Name",
      description: "Used in email communications with the employee.",
    },
    companyInfoNotificationEmail: {
      type: "string",
      label: "Company Info Notification Email",
      description: "Optional email address for updates on the status of this device return.",
      optional: true,
    },
  },
  methods: {
    createDeviceReturn(args = {}) {
      return this.app.post({
        path: "/device_returns/",
        ...args,
      });
    },
  },
  async run({ $: step }) {
    const {
      createDeviceReturn,
      requestCharger,
      employeeInfoEmail,
      employeeInfoName,
      employeeInfoAddressLine1,
      employeeInfoAddressLine2,
      employeeInfoAddressCity,
      employeeInfoAddressState,
      employeeInfoAddressZip,
      companyInfoReturnRecipientName,
      companyInfoReturnAddressCompany,
      companyInfoReturnAddressLine1,
      companyInfoReturnAddressLine2,
      companyInfoReturnAddressCity,
      companyInfoReturnAddressState,
      companyInfoReturnAddressZip,
      companyInfoDisplayName,
      companyInfoNotificationEmail,
    } = this;

    const response = await createDeviceReturn({
      step,
      data: {
        request_charger: requestCharger,
        employee_info: {
          email: employeeInfoEmail,
          name: employeeInfoName,
          address_line_1: employeeInfoAddressLine1,
          address_line_2: employeeInfoAddressLine2,
          address_city: employeeInfoAddressCity,
          address_state: employeeInfoAddressState,
          address_zip: employeeInfoAddressZip,
        },
        company_info: {
          return_recipient_name: companyInfoReturnRecipientName,
          return_address_company: companyInfoReturnAddressCompany,
          return_address_line_1: companyInfoReturnAddressLine1,
          return_address_line_2: companyInfoReturnAddressLine2,
          return_address_city: companyInfoReturnAddressCity,
          return_address_state: companyInfoReturnAddressState,
          return_address_zip: companyInfoReturnAddressZip,
          display_name: companyInfoDisplayName,
          notification_email: companyInfoNotificationEmail,
        },
      },
    });

    step.export("$summary", `Successfully created device return order with ID \`${response.id}\``);

    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.

LabelPropTypeDescription
RetrieverappappThis component uses the Retriever app.
Request ChargerrequestChargerboolean

Whether or not to request a charger with the device return.

Employee Info EmailemployeeInfoEmailstring

Optional email address for notifying the employee when a box ships and is delivered, as well as sending reminders.

Employee Info NameemployeeInfoNamestring

The employee name to print on the shipping label.

Employee Info Address Line 1employeeInfoAddressLine1string

The first line of the employee's address (typically the street address), or a full, comma-separated address. If providing the Employee Info Address Line 1, Employee Info Address City, Employee Info Address State, and Employee Info Address Zip are required (Employee Info Address Line 2 remains optional). If providing a full address, it is best to use the format 1 Main St, New York, NY 10001 or 1 Main St, Apt 200, New York, NY 10001. We will attempt to parse any full address, but cannot guarantee accuracy - especially if other formats are used. It is highly recommended to provide the address in separate fields.

Employee Info Address Line 2employeeInfoAddressLine2string

Optional second line of the employee's address.

Employee Info Address CityemployeeInfoAddressCitystring

Optional if a full address is provided in Employee Info Address Line 1. Required otherwise.

Employee Info Address StateemployeeInfoAddressStatestring

Optional if a full address is provided in Employee Info Address Line 1. Required otherwise.

Employee Info Address ZipemployeeInfoAddressZipstring

Optional if a full address is provided in Employee Info Address Line 1. Required otherwise.

Company Info Return Recipient NamecompanyInfoReturnRecipientNamestring

The return recipient name to print on the shipping label.

Company Info Return Address CompanycompanyInfoReturnAddressCompanystring

The return recipient company to print on the shipping label.

Company Info Return Address Line 1companyInfoReturnAddressLine1string

The first line of the return address (typically the street address), or a full, comma-separated address. If providing the Company Info Return Address Line 1, Company Info Return Address City, Company Info Return Address State, and Company Info Return Address Zip are required (Company Info Return Address Line 2 remains optional). If providing a full address, it is best to use the format 1 Main St, New York, NY 10001 or 1 Main St, Apt 200, New York, NY 10001. We will attempt to parse any full address, but cannot guarantee accuracy - especially if other formats are used. It is highly recommended to provide the address in separate fields.

Company Info Return Address Line 2companyInfoReturnAddressLine2string

Optional second line of the return address.

Company Info Return Address CitycompanyInfoReturnAddressCitystring

Optional if a full address is provided in Company Info Return Address Line 1. Required otherwise.

Company Info Return Address StatecompanyInfoReturnAddressStatestring

Optional if a full address is provided in Company Info Return Address Line 1. Required otherwise.

Company Info Return Address ZipcompanyInfoReturnAddressZipstring

Optional if a full address is provided in Company Info Return Address Line 1. Required otherwise.

Company Info Display NamecompanyInfoDisplayNamestring

Used in email communications with the employee.

Company Info Notification EmailcompanyInfoNotificationEmailstring

Optional email address for updates on the status of this device return.

Action Authentication

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

Sign in and copy your API Key from API option in the left navigation menu.

About Retriever

Easy laptop and monitor returns for employee offboarding, upgrades, and repairs.

More Ways to Connect Retriever + Microsoft Teams

Get Order with Retriever API on New Channel Message from Microsoft Teams API
Microsoft Teams + Retriever
 
Try it
Get Order with Retriever API on New Channel from Microsoft Teams API
Microsoft Teams + Retriever
 
Try it
Get Order with Retriever API on New Chat Message from Microsoft Teams API
Microsoft Teams + Retriever
 
Try it
Get Order with Retriever API on New Chat from Microsoft Teams API
Microsoft Teams + Retriever
 
Try it
Get Order with Retriever API on New Team Member from Microsoft Teams API
Microsoft Teams + Retriever
 
Try it
New Channel from the Microsoft Teams API

Emit new event when a new channel is created within a team

 
Try it
New Channel Message from the Microsoft Teams API

Emit new event when a new message is posted in a channel

 
Try it
New Chat from the Microsoft Teams API

Emit new event when a new chat is created

 
Try it
New Chat Message from the Microsoft Teams API

Emit new event when a new message is received in a chat

 
Try it
New Team from the Microsoft Teams API

Emit new event when a new team is joined by the authenticated user

 
Try it
Create Channel with the Microsoft Teams API

Create a new channel in Microsoft Teams. See the docs here

 
Try it
List Channels with the Microsoft Teams API

Lists all channels in a Microsoft Team. See the docs here

 
Try it
List Shifts with the Microsoft Teams API

Get the list of shift instances for a team. See the documentation

 
Try it
Send Channel Message with the Microsoft Teams API

Send a message to a team's channel. See the docs here

 
Try it
Send Chat Message with the Microsoft Teams API

Send a message to a team's chat. See the docs here

 
Try it

Explore Other Apps

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

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Premium
Salesforce
Salesforce
Web services API for interacting with Salesforce
Premium
HubSpot
HubSpot
HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business.
Premium
Zoho CRM
Zoho CRM
Zoho CRM is an online Sales CRM software that manages your sales, marketing, and support in one CRM platform.
Premium
Stripe
Stripe
Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Premium
WooCommerce
WooCommerce
WooCommerce is the open-source ecommerce platform for WordPress.
Premium
Snowflake
Snowflake
A data warehouse built for the cloud
Premium
MongoDB
MongoDB
MongoDB is an open source NoSQL database management program.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.