# Open Preview: Workflows Beta API **URL:** \ **Category:** In Discovery\ **Tags:** identity-security-cloud, open-preview\ **Created:** [October 6, 2021, 1:30pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733 "2021-10-06T13:30:40Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [October 6, 2021, 1:30pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/1 "2021-10-06T13:30:40Z")
The [Workflows](https://developer.sailpoint.com/idn/api/beta/workflows) API collection has been released in beta. This API collection can be used to programmatically create and manage workflows in IdentityNow. To sign up for the Workflows beta program, please fill out [this Smartsheet form](https://app.smartsheet.com/b/form/e758ab109dc649589f57b4b5c41d4373). You must be a customer or partner in order to participate in the beta program. You can learn more about workflows by reading [Creating and Managing Workflows - SailPoint Identity Services](https://documentation.sailpoint.com/saas/help/workflows/workflow-basics.html) Here are a couple of JSON examples to get you started. [example-workflow-00-hello-world.json](https://developer.sailpoint.com/discuss/uploads/short-url/agntMFucu3kjm8Y0gNSay25fZ1N.json) (1.0 KB) [example-workflow-01-mover.json](https://developer.sailpoint.com/discuss/uploads/short-url/s73Od7ks4rxI4RjFygrENshKaQp.json) (2.8 KB) ---
**Author:** ![BartCoolsUpright](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/bartcoolsupright/32/14196_2.png) [@BartCoolsUpright](https://developer.sailpoint.com/discuss/u/BartCoolsUpright)\ **Post date:** [October 6, 2021, 6:15pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/2 "2021-10-06T18:15:49Z")
Hi Colin, thank you for the API reference on Workflows! Currently we’re not seeing the ‘Visual Builder’ in our IDN Beta as mentioned in the documentation. Will the Visual Builder be launched in the coming days? ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [October 6, 2021, 6:34pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/3 "2021-10-06T18:34:42Z")
Sorry about that. I updated my post to include the signup form. ---
**Author:** ![BartCoolsUpright](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/bartcoolsupright/32/14196_2.png) [@BartCoolsUpright](https://developer.sailpoint.com/discuss/u/BartCoolsUpright)\ **Post date:** [October 6, 2021, 6:37pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/4 "2021-10-06T18:37:15Z")
Hi Colin, thanks but I already submitted the signup form last week but maybe it is still being processed. I’ll check again early next week! ---
**Author:** ![matt\_totty](https://avatars.discourse-cdn.com/v4/letter/m/7ea924/32.png) [@matt\_totty](https://developer.sailpoint.com/discuss/u/matt_totty)\ **Post date:** [October 6, 2021, 6:50pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/5 "2021-10-06T18:50:54Z")
Same situation. Seems everything is in the partner tenants but no docs on how to proceed manually or with a visual builder. ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [October 6, 2021, 7:00pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/6 "2021-10-06T19:00:30Z")
@BartCoolsUpright, please reach out to your Customer Success Manager or Account Executive to check the status of your request. It likely has been approved but not activated yet, and one of those two persons should be able to move it along. ---
**Author:** ![emarks\_clango](https://avatars.discourse-cdn.com/v4/letter/e/ec9cab/32.png) [@emarks\_clango](https://developer.sailpoint.com/discuss/u/emarks_clango)\ **Post date:** [October 7, 2021, 1:09pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/7 "2021-10-07T13:09:11Z")
Any chance someone can post a basic JSON file to at least get us started while we wait for the builder to get approved/deployed? ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [October 7, 2021, 1:11pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/8 "2021-10-07T13:11:29Z")
Here’s a couple examples. [example-workflow-00-hello-world.json](https://developer.sailpoint.com/discuss/uploads/short-url/agntMFucu3kjm8Y0gNSay25fZ1N.json) (1.0 KB) [example-workflow-01-mover.json](https://developer.sailpoint.com/discuss/uploads/short-url/s73Od7ks4rxI4RjFygrENshKaQp.json) (2.8 KB) ---
**Author:** ![ethompson](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/ethompson/32/17298_2.png) [@ethompson](https://developer.sailpoint.com/discuss/u/ethompson)\ **Post date:** [November 8, 2021, 5:46pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/9 "2021-11-08T17:46:01Z")
Is there a place to get more updates on Workflows other than the documentation page? Our tenant has the beta but I am trying to find more information or examples of how to use the various triggers and actions. ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [November 8, 2021, 8:22pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/10 "2021-11-08T20:22:47Z")
@ethompson, Currently, the only documentation we have is at [Creating and Managing Workflows - SailPoint Identity Services](https://documentation.sailpoint.com/saas/help/workflows/workflow-basics.html). Workflows is still pretty new and not generally available yet, but more documentation and examples will be made available over time. ---
**Author:** ![jsr749](https://avatars.discourse-cdn.com/v4/letter/j/eb8c5e/32.png) [@jsr749](https://developer.sailpoint.com/discuss/u/jsr749)\ **Post date:** [November 8, 2021, 8:27pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/11 "2021-11-08T20:27:47Z")
I tried setting up a certification campaign to trigger when the user’s division changes. My trigger is working, but I see this error when the workflow tries to run the campaign: {“error”:"actionStep(createCertification) Error: task failed: activity error (type: sp:create:campaign, scheduledEventID: 5, startedEventID: 6, identity: 1@a627fa796f3c@): Post "[https://sw-sb.cms.services.infra.identitynow.com/beta/campaigns":](https://sw-sb.cms.services.infra.identitynow.com/beta/campaigns%22:) request failed with status 401 (type: HTTP Response Returned a Client Error, retryable: false): Post “[https://sw-sb.cms.services.infra.identitynow.com/beta/campaigns":](https://sw-sb.cms.services.infra.identitynow.com/beta/campaigns%22:) request failed with status 401 (type: Error, retryable: true): request failed with status 401”} ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [November 8, 2021, 8:29pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/12 "2021-11-08T20:29:19Z")
@jsr749, a `401` response code means your authentication token is expired, invalid, or missing. ---
**Author:** ![jsr749](https://avatars.discourse-cdn.com/v4/letter/j/eb8c5e/32.png) [@jsr749](https://developer.sailpoint.com/discuss/u/jsr749)\ **Post date:** [November 8, 2021, 8:30pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/13 "2021-11-08T20:30:16Z")
@colin_mckibben, But how does that work in the context of the workflow? Do we have to setup an authentication token as part of the workflow config? ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [November 8, 2021, 8:36pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/14 "2021-11-08T20:36:18Z")
@jsr749, can you create a topic in the IDN channel for this? That way we can track the solution better. ---
**Author:** ![gautam\_vasista](https://avatars.discourse-cdn.com/v4/letter/g/6a8cbe/32.png) [@gautam\_vasista](https://developer.sailpoint.com/discuss/u/gautam_vasista)\ **Post date:** [November 8, 2021, 8:40pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/15 "2021-11-08T20:40:48Z")
> [@colin\_mckibben](#): > > @ethompson, The Workflows Beta team also prefers any feedback inside the tool itself. You should be able to go into the tool and give feedback there as well if you have questions. They have a team monitoring that as well. ---
**Author:** ![tranetechnologies](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/tranetechnologies/32/1062_2.png) [@tranetechnologies](https://developer.sailpoint.com/discuss/u/tranetechnologies)\ **Post date:** [November 10, 2021, 4:16pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/16 "2021-11-10T16:16:56Z")
@colin_mckibben I was unable to see a way to leave feedback in Tool itself, however I did import one of the examples provided and I get “output was not a valid map”. Same thing I got when I tried to create my own. Obviously this is a very bad first impression and the message is not even remotely helpful to understanding what this occurred, where to fix. I’m hopeful others will join the beta in order to encourage SailPoint to put more examples up and enrich the documentation as we want to be activity engaged so that a viable solution is available for us all. { “type”: “WorkflowExecutionFailed”, “timestamp”: “2021-11-10T16:12:15.148847016Z”, “attributes”: { “error”: “output was not a valid map” } } ---
**Author:** ![MattUribe](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/matturibe/32/20300_2.png) [@MattUribe](https://developer.sailpoint.com/discuss/u/MattUribe)\ **Post date:** [November 10, 2021, 4:33pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/17 "2021-11-10T16:33:34Z")
I was getting that same error for “Send Email” until I put a $ into the Templating Context. It would be nice to have a better understanding of how to work with the Templating Context. I understand the JSON path, but how Templating Context should be formatted to be used in the Body, Subject, etc., is what I am missing. Further, if I include a $ in the Body, rather than getting the JSON object formatted the same as it went in, it’s formatted differently, with a lot of map interspersed throughout. Perhaps that’s a result of what I put in the Templating Context, but it’s not intuitive. Some basic examples in the documentation would go a long way, in my opinion. ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [November 10, 2021, 5:55pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/18 "2021-11-10T17:55:16Z")
@tranetechnologies, you should see a “Provide Feedback” button on the main workflows page. ![IDN_Enterprise504](https://global.discourse-cdn.com/sailpoint/original/1X/b8ce05bc287c27eb538f6ab8742bac189eb796b1.png) ---
**Author:** ![tranetechnologies](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/tranetechnologies/32/1062_2.png) [@tranetechnologies](https://developer.sailpoint.com/discuss/u/tranetechnologies)\ **Post date:** [November 15, 2021, 2:45pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/19 "2021-11-15T14:45:37Z")
Not there, sorry. ![image](https://global.discourse-cdn.com/sailpoint/original/1X/bd6ea2fb925adeaddc891663662c3cc19f93bd33.jpeg) ---
**Author:** ![colin\_mckibben](https://sea1.discourse-cdn.com/sailpoint/discuss/user_avatar/developer.sailpoint.com/colin_mckibben/32/37182_2.png) [@colin\_mckibben](https://developer.sailpoint.com/discuss/u/colin_mckibben)\ **Post date:** [November 15, 2021, 2:46pm UTC](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733/20 "2021-11-15T14:46:53Z")
That’s a bug. Can you please submit a support ticket? They will be able to investigate and fix this. [Next page](https://developer.sailpoint.com/discuss/t/open-preview-workflows-beta-api/1733.md?page=2)