Auto-Generate A JumpCloud Connector on Workato
That’s right, the JumpCloud connector can be generated in a split second!
In case you don't already know:
The memory is still vivid back to the days when I was using JumpCloud connector extensively on Workato — The handwritten Ruby codes translated from the pages of API documents, and the ongoing maintenance effort to keep up with the changes.
Not fun at all! And effort/labour intensive!
Until I was introduced to the OpenAPI connector recently — Since JumpCloud’s API is built on OpenAPI 2.0 standard, I decided to give it a go.
It turns out surprisingly smooth, and took me no more than 20 mins to get going! Take a look at this:
How-To Steps
- Go to a project in Workato -> Create -> Connection.
2. Search for OpenAPI -> Name it -> Connection type — “Cloud”.
3. OpenAPI document source — Document URL.
4. You can find the OpenAPI (Swagger) Spec file links for JumpCloud APIs here:
- JC API V1
- JC API V2
- JC Directory Insights
- You might need to create 3 connectors respectively for the listed above.
5. Authentication Method -> Header -> Header authorization -> Input your JC API key like this:
x-api-key:<your-jc-api-key>
6. Click Connect. Almost there 😄.
7. Now create a recipe (if none exists), and pick your trigger.
8. Add an action -> Action in an App -> OpenAPI -> Pick an action, i.e. “Create Record”.
9. Choose the connection you just created.
10. Pick an item you wanted to create in “Object”:
11. You can always go back to “Action” for other operations like deleting objects, getting info, searching info, updating items etc.
12. The rest of the callable API endpoints will be grouped in “Execute operation” if you couldn’t find the operation you need in those default actions.
That’s it, enjoy the magic power of automation!