Etsy Plugin

How to setup

User Authorization

the first step is to direct the use user to Etsy to provide authorization to their account. The flow is as follows,

Document image

An overview of the authorization flow.

  1. Use the "(1) ETSY Authorize" action and provide a redirect URL & your needed scopes.
Document image

2. Next we want to 'Make changes to current user'.

Document image

3. Now using the '(2) ETSY Authorize' action we will send them to Etsy.

After Authorization

When a user is redirected back to your app, we handle this with the following flow.

Document image

The flow is set to run under the condition 'Do when Get from page url' 'oauth_verifier' 'is not empty'.

  1. First we need to get an Access Token.
Document image

2. Then store the token.

Document image

3. Now clean the URL up.

Document image

Making API Calls

After making sure your app is exposing a Workflow API, navigate there and create endpoints. To provide some insight on what we are doing imagine that when you make a call to Etsy for data using the 'New API Call' flow, that the requested data is now going to be packaged up and sent to your endpoint.

So if we were to make a data call and were after 'The Current User', we would make this call,

Document image

Your endpoint url should look similar to this pattern:

or when initializing:

The first time you make this call you will need to use the initialize address for the endpoint and make sure you have auto detect selected and running in a new window.

Document image

Why do we use this method?

  • You are able to then select what field types you require in the returned data.
  • You can make calls to your services endpoints that are not predefined in the plugin.
  • You can add parameters to the data call's URL to narrow down the requested results
  • You are able to receive complete objects - Great for sync type calls where you pull all data from endpoints and your done.

How do you know who the returned data is for?

By ensuring you have the 'Include headers in the detected data' selected, you will see each time data is posted to the endpoint you will have a header labeled 'bubble_user' and the value is the currant user's unique ID.