logo

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,
Image without caption
An overview of the authorization flow.
  1. Use the "(1) ETSY Authorize" action and provide a redirect URL & your needed scopes.
Image without caption
2. Next we want to 'Make changes to current user'.
Image without caption
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.
Image without caption
☝
Note: 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.
Image without caption
2. Then store the token.
Image without caption
3. Now clean the URL up.
Image without caption

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,
Image without caption
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.
Image without caption
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.

Helpful?