Connectors Reference

Way We Do

Way We Do enables teams to actively use repeatable policies, procedures, processes and playbooks in their day to day workflows to increase efficiency, quality and compliance.

 

Status: Preview

Tier: Premium

Version: v1

 

Actions:

Name

Summary

Comment_Add (Comment_AddParameterCreateCommentCommand CreateCommentCommand)

Add a comment to a checklist instance step

GetAll_ChecklistInstances ([advanced][Optional]integer limit, [advanced][Optional]integer offset, [advanced][Optional]integer status)

Get All Checklist Instances

ChecklistInstances_Post (ChecklistInstances_PostParameterCreateInstanceCommand CreateInstanceCommand)

Create Checklist Instance

ChecklistInstances_Get (string instanceId)

Get A Checklist Instance

ChecklistInstances_Activity (string instanceId)

Get Checklist Instance Activity

Find_Steps (string instanceId, [Optional]string query)

Find Checklist Step

ChecklistSteps_Get (string instanceId, string stepId)

Get A Checklist Step

ChecklistSteps_Complete (string instanceId, string stepId, [Optional]ChecklistSteps_CompleteParameterComplete Step Command Complete Step Command)

Complete a Checklist Step

Company_GetCompany ()

Get Company

CompanyRoles_GetAll ()

Get Company Roles

ProcedureAcceptances_GetAll ([advanced][Optional]integer limit, [advanced][Optional]integer offset)

Get All Procedure Acceptances

Find_Checklist ([Optional]string query, [internal]integer type)

Find Checklist

Procedures_Get (integer procedureId)

Get A Checklist

Find_Checklist_Instances (integer procedureId, [Optional]string query)

Find Checklist Instance

SecurityRoles_IdTitle ()

Get Security Roles

TimeZones_Get ()

Get Time Zones

Users_Get (integer userId)

Get User

Find_User ([Optional]string query)

Find User

Users_Post (Users_PostParameterCreate User Command Create User Command)

Add a New User

 

Triggers:

Name

Summary

Checklist_Create_WebHook (Checklist_Create_WebHookParameterWebhook Registration Webhook Registration)

When a checklist instance is started

New_Comment_WebHook (New_Comment_WebHookParameterWebhook Registration Webhook Registration)

When a comment is added to a checklist

Finish_Checklist_WebHook (Finish_Checklist_WebHookParameterWebhook Registration Webhook Registration)

When a checklist is finished

Invite_Supervisor_WebHook (Invite_Supervisor_WebHookParameterWebhook Registration Webhook Registration)

When a supervisor is invited

Generate_Acceptance_PDF_WebHook (Generate_Acceptance_PDF_WebHookParameterWebhook Registration Webhook Registration)

When a procedure is accepted

Checklist_Step_Completed_WebHook (Checklist_Step_Completed_WebHookParameterWebhook Registration Webhook Registration)

When a checklist step is completed

 

Objects:

Name

Summary

ChecklistComment

 

ChecklistInstance

 

ChecklistInstances_ActivityResponseItem

 

ChecklistInstances_PostParameterCreateInstanceCommand

 

ChecklistStep

 

ChecklistSteps_CompleteParameterComplete Step Command

 

ChecklistSteps_CompleteResponse

 

Checklist_Create_WebHookParameterWebhook Registration

 

Checklist_Step_Completed_WebHookParameterWebhook Registration

 

Comment_AddParameterCreateCommentCommand

 

CompanyRoles_GetAllResponseItem

 

Company_GetCompanyResponse

 

Finish_Checklist_WebHookParameterWebhook Registration

 

Generate_Acceptance_PDF_WebHookParameterWebhook Registration

 

GetAll_ChecklistInstancesResponse

 

Invite_Supervisor_WebHookParameterWebhook Registration

 

New_Comment_WebHookParameterWebhook Registration

 

Procedure

 

ProcedureAcceptance

 

ProcedureAcceptances_GetAllResponse

 

SecurityRoles_IdTitleResponseItem

 

TimeZones_GetResponseItem

 

User

 

Users_PostParameterCreate User Command

 

Users_PostResponse

 

WebhookRegistered

 

 

Actions:

Comment_Add

Summary: Add a comment to a checklist instance step

Description: Adds a new comment to an Activated Checklist Instance step.

 

Syntax:

WayWeDo.Comment_Add (Comment_AddParameterCreateCommentCommand CreateCommentCommand)

 

Parameters:

Name

Type

Summary

Required

Related Action

CreateCommentCommand

Comment_AddParameterCreateCommentCommand

 

 

True

 

Returns:

          Type:ChecklistComment

 

GetAll_ChecklistInstances

Summary: Get All Checklist Instances

Description: Retrieves a list of all activated checklist instances.

 

Syntax:

WayWeDo.GetAll_ChecklistInstances ([advanced][Optional]integer limit, [advanced][Optional]integer offset, [advanced][Optional]integer status)

 

Parameters:

Name

Type

Summary

Required

Related Action

limit

integer(int32)

(Limit)

Maximum number of results to fetch.

False

offset

integer(int32)

(Offset)

The number of records skipped.

False

status

integer(int32)

(Status)

The status of instances returned.

False

 

Returns:

          Type:GetAll_ChecklistInstancesResponse

 

ChecklistInstances_Post

Summary: Create Checklist Instance

Description: Creates a new activated checklist instance.

 

Syntax:

WayWeDo.ChecklistInstances_Post (ChecklistInstances_PostParameterCreateInstanceCommand CreateInstanceCommand)

 

Parameters:

Name

Type

Summary

Required

Related Action

CreateInstanceCommand

ChecklistInstances_PostParameterCreateInstanceCommand

 

 

True

 

Returns:

          Type:ChecklistInstance

 

ChecklistInstances_Get

Summary: Get A Checklist Instance

Description: Retrieves a specific activated checklist instance

 

Syntax:

WayWeDo.ChecklistInstances_Get (string instanceId)

 

Parameters:

Name

Type

Summary

Required

Related Action

instanceId

string(guid)

(Instance ID)

Select the checklist instance

True

Find_Checklist

 

Returns:

          Type:ChecklistInstance

 

ChecklistInstances_Activity

Summary: Get Checklist Instance Activity

Description: Retrieve all activity for a checklist instance

 

Syntax:

WayWeDo.ChecklistInstances_Activity (string instanceId)

 

Parameters:

Name

Type

Summary

Required

Related Action

instanceId

string(guid)

(Instance Id)

Select the checklist instance

True

GetAll_ChecklistInstances

 

Returns:

          Type:array of (ChecklistInstances_ActivityResponseItem)

 

Find_Steps

Summary: Find Checklist Step

Description: Find a step of a checklist instance

 

Syntax:

WayWeDo.Find_Steps (string instanceId, [Optional]string query)

 

Parameters:

Name

Type

Summary

Required

Related Action

instanceId

string(guid)

(Instance Id)

Select the checklist instance

True

GetAll_ChecklistInstances

query

string

(Step Title)

Search for a step title

False

 

Returns:

          Type:array of (ChecklistStep)

 

ChecklistSteps_Get

Summary: Get A Checklist Step

Description: Retrieves a specific checklist step

 

Syntax:

WayWeDo.ChecklistSteps_Get (string instanceId, string stepId)

 

Parameters:

Name

Type

Summary

Required

Related Action

instanceId

string(guid)

(Instance Id)

Select the checklist instance

True

GetAll_ChecklistInstances

stepId

string(guid)

(Step Id)

Select the checklist step

True

Find_Steps

 

Returns:

          Type:ChecklistStep

 

ChecklistSteps_Complete

Summary: Complete a Checklist Step

Description: Mark a specific step in a checklist instance as complete.

 

Syntax:

WayWeDo.ChecklistSteps_Complete (string instanceId, string stepId, [Optional]ChecklistSteps_CompleteParameterComplete Step Command Complete Step Command)

 

Parameters:

Name

Type

Summary

Required

Related Action

instanceId

string(guid)

(Instance Id)

Select the checklist instance

True

GetAll_ChecklistInstances

stepId

string(guid)

(Step Id)

Select the checklist step

True

Find_Steps

Complete Step Command

ChecklistSteps_CompleteParameterComplete Step Command

 

 

False

 

Returns:

          Type:ChecklistSteps_CompleteResponse

 

Company_GetCompany

Summary: Get Company

Description: Retrieves your company ID and Name

 

Syntax:

WayWeDo.Company_GetCompany ()

 

Returns:

          Type:Company_GetCompanyResponse

 

CompanyRoles_GetAll

Summary: Get Company Roles

Description: Retrieve all the company roles.

 

Syntax:

WayWeDo.CompanyRoles_GetAll ()

 

Returns:

          Type:array of (CompanyRoles_GetAllResponseItem)

 

ProcedureAcceptances_GetAll

Summary: Get All Procedure Acceptances

Description: Retrieves a list of all procedure acceptances.

 

Syntax:

WayWeDo.ProcedureAcceptances_GetAll ([advanced][Optional]integer limit, [advanced][Optional]integer offset)

 

Parameters:

Name

Type

Summary

Required

Related Action

limit

integer(int32)

(Limit)

Maximum number of results to fetch.

False

offset

integer(int32)

(Offset)

The number of records skipped.

False

 

Returns:

          Type:ProcedureAcceptances_GetAllResponse

 

Find_Checklist

Summary: Find Checklist

Description: Search for a checklist by title

 

Syntax:

WayWeDo.Find_Checklist ([Optional]string query, [internal]integer type)

 

Parameters:

Name

Type

Summary

Required

Related Action

query

string

(Checklist Title)

The title of the checklist

False

type

integer(int32)

(Procedure Type)

The type of procedure; either 1 (standard) or 2 (checklist).

True

 

Returns:

          Type:array of (Procedure)

 

Procedures_Get

Summary: Get A Checklist

Description: Retrieves a specific checklist or procedure by ID.

 

Syntax:

WayWeDo.Procedures_Get (integer procedureId)

 

Parameters:

Name

Type

Summary

Required

Related Action

procedureId

integer(int32)

(Procedure ID)

Select a checklist

True

Find_Checklist

 

Returns:

          Type:Procedure

 

Find_Checklist_Instances

Summary: Find Checklist Instance

Description: Search for a checklist instance by title.

 

Syntax:

WayWeDo.Find_Checklist_Instances (integer procedureId, [Optional]string query)

 

Parameters:

Name

Type

Summary

Required

Related Action

procedureId

integer(int32)

(Procedure ID)

Select a checklist

True

Find_Checklist

query

string

(Instance Title)

The title of the checklist instance.

False

 

Returns:

          Type:array of (ChecklistInstance)

 

SecurityRoles_IdTitle

Summary: Get Security Roles

Description: Retrieve a list of all security roles

 

Syntax:

WayWeDo.SecurityRoles_IdTitle ()

 

Returns:

          Type:array of (SecurityRoles_IdTitleResponseItem)

 

TimeZones_Get

Summary: Get Time Zones

Description: Rectrieve a list of all time zones.

 

Syntax:

WayWeDo.TimeZones_Get ()

 

Returns:

          Type:array of (TimeZones_GetResponseItem)

 

Users_Get

Summary: Get User

Description: Retrieves a specific user by ID

 

Syntax:

WayWeDo.Users_Get (integer userId)

 

Parameters:

Name

Type

Summary

Required

Related Action

userId

integer(int32)

(User ID)

Select the user.

True

Find_User

 

Returns:

          Type:User

 

Find_User

Summary: Find User

Description: Search for a user by name or email.

 

Syntax:

WayWeDo.Find_User ([Optional]string query)

 

Parameters:

Name

Type

Summary

Required

Related Action

query

string

(Email Address Or Name)

The name or email address of the user.

False

 

Returns:

          Type:array of (User)

 

Users_Post

Summary: Add a New User

Description: Creates and invites a new user.

 

Syntax:

WayWeDo.Users_Post (Users_PostParameterCreate User Command Create User Command)

 

Parameters:

Name

Type

Summary

Required

Related Action

Create User Command

Users_PostParameterCreate User Command

 

 

True

 

Returns:

          Type:Users_PostResponse

 

Triggers:

Trigger Checklist_Create_WebHook

Summary: When a checklist instance is started

Description: This operation triggers when a checklist instance is started.

 

Syntax:

WayWeDo.Checklist_Create_WebHook (Checklist_Create_WebHookParameterWebhook Registration Webhook Registration)

 

Parameters:

Name

Type

Summary

Required

Related Action

Webhook Registration

Checklist_Create_WebHookParameterWebhook Registration

 

 

True

 

Returns:

          Type:WebhookRegistered

 

Trigger New_Comment_WebHook

Summary: When a comment is added to a checklist

Description: This operation triggers when a new comment is added to a checklist.

 

Syntax:

WayWeDo.New_Comment_WebHook (New_Comment_WebHookParameterWebhook Registration Webhook Registration)

 

Parameters:

Name

Type

Summary

Required

Related Action

Webhook Registration

New_Comment_WebHookParameterWebhook Registration

 

 

True

 

Returns:

          Type:WebhookRegistered

 

Trigger Finish_Checklist_WebHook

Summary: When a checklist is finished

Description: This operation triggers when a checklist is finished.

 

Syntax:

WayWeDo.Finish_Checklist_WebHook (Finish_Checklist_WebHookParameterWebhook Registration Webhook Registration)

 

Parameters:

Name

Type

Summary

Required

Related Action

Webhook Registration

Finish_Checklist_WebHookParameterWebhook Registration

 

 

True

 

Returns:

          Type:WebhookRegistered

 

Trigger Invite_Supervisor_WebHook

Summary: When a supervisor is invited

Description: This operation triggers when a supervisor invite is generated.

 

Syntax:

WayWeDo.Invite_Supervisor_WebHook (Invite_Supervisor_WebHookParameterWebhook Registration Webhook Registration)

 

Parameters:

Name

Type

Summary

Required

Related Action

Webhook Registration

Invite_Supervisor_WebHookParameterWebhook Registration

 

 

True

 

Returns:

          Type:WebhookRegistered

 

Trigger Generate_Acceptance_PDF_WebHook

Summary: When a procedure is accepted

Description: This operation triggers when a procedure is accepted.

 

Syntax:

WayWeDo.Generate_Acceptance_PDF_WebHook (Generate_Acceptance_PDF_WebHookParameterWebhook Registration Webhook Registration)

 

Parameters:

Name

Type

Summary

Required

Related Action

Webhook Registration

Generate_Acceptance_PDF_WebHookParameterWebhook Registration

 

 

True

 

Returns:

          Type:WebhookRegistered

 

Trigger Checklist_Step_Completed_WebHook

Summary: When a checklist step is completed

Description: This operation triggers when a checklist step is completed.

 

Syntax:

WayWeDo.Checklist_Step_Completed_WebHook (Checklist_Step_Completed_WebHookParameterWebhook Registration Webhook Registration)

 

Parameters:

Name

Type

Summary

Required

Related Action

Webhook Registration

Checklist_Step_Completed_WebHookParameterWebhook Registration

 

 

True

 

Returns:

          Type:WebhookRegistered

 


 

ChecklistComment

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Comment ID

The unique ID of the comment.

type

integer

Comment Type

The type of comment; either 1 (standard) or 2 (attachment).  Values: [, ]

procedureId

integer(int32)

Procedure ID

The unique ID of the procedure.

procedureTitle

string

Procedure Title

The title of the procedure.

instanceId

string

Instance ID

The unique ID of the checklist instance.

stepId

string

Step ID

The unique ID of the checklist step.

instanceTitle

string

Instance Title

The title of the checklist instance.

comment

string

Comment Text

The comment text added to the step.

created

string(date-time)

Comment Date

The date and time the comment was created.

createdBy

string

Comment User

The email address of the user who created the comment.

imageUrl

string

Comment Attachment URL

The URL to the attached file. Valid for 5 minutes.


 

ChecklistInstance

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Instance ID

The unique ID of the checklist instance.

procedureId

integer(int32)

Procedure ID

The unique ID of the procedure.

title

string

Instance Title

The title of the checklist instance.

url

string

Instance URL

The URL to the checklist instance.

created

string(date-time)

Instance Created Date

The date and time the checklist instance was started.

createdBy

string

Instance User

The email address of the user who started the checklist instance.

finished

string(date-time)

Instance Finish Date

The date and time the checklist instance was finished.


 

ChecklistInstances_ActivityResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

occurred

string(date-time)

Occurred

The date and time the activity occurred.

title

string

Description

A description of the activity that occurred.


 

ChecklistInstances_PostParameterCreateInstanceCommand

Summary:

Description:

 

          Properties:

Name

Type

Summary

procedureId

integer(int32)

Procedure ID

Select a checklist master

title

string

Title

The title of the checklist instance

userId

integer(int32)

User ID

Select the user creating the instance

bot

string

Bot Name

The name of the bot creating the instance


 

ChecklistStep

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Step ID

The unique ID of the instance step.

title

string

Step Title

The title of the instance step.

ordinal

integer(int32)

Step Number

The number of the instance step.


 

ChecklistSteps_CompleteParameterComplete Step Command

Summary:

Description:

 

          Properties:

Name

Type

Summary

userId

integer(int32)

User ID

Select the user completing the step

bot

string

Bot Name

The name of the bot that completed the checklist step


 

ChecklistSteps_CompleteResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary


 

Checklist_Create_WebHookParameterWebhook Registration

Summary:

Description:

 

          Properties:

Name

Type

Summary

callbackUrl

string

Callback URL

The URL to call when action occurs.


 

Checklist_Step_Completed_WebHookParameterWebhook Registration

Summary:

Description:

 

          Properties:

Name

Type

Summary

callbackUrl

string

Callback URL

The URL to call when action occurs.


 

Comment_AddParameterCreateCommentCommand

Summary:

Description:

 

          Properties:

Name

Type

Summary

instanceId

string

Checklist Instance ID

Select the checklist instance

stepId

string

Step ID

Select the step of the checklist instance

userId

integer(int32)

User ID

Select the user creating the comment

message

string

Comment Text

Specify the comment to add

bot

string

Bot Name

The name of the bot creating the comment


 

CompanyRoles_GetAllResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Role ID

The unique ID of the company role.

title

string(date-time)

Role Title

The name of the company role.


 

Company_GetCompanyResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Company ID

The unique ID of your company.

title

string

Company Title

The name of the company registered with Way We Do


 

Finish_Checklist_WebHookParameterWebhook Registration

Summary:

Description:

 

          Properties:

Name

Type

Summary

callbackUrl

string

Callback URL

The URL to call when action occurs.


 

Generate_Acceptance_PDF_WebHookParameterWebhook Registration

Summary:

Description:

 

          Properties:

Name

Type

Summary

callbackUrl

string

Callback URL

The URL to call when action occurs.


 

GetAll_ChecklistInstancesResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

results

array of (ChecklistInstance)

Checklist Instances

The list of checklist instances.

_total

integer(int32)

Total

The total number of checklist instances.


 

Invite_Supervisor_WebHookParameterWebhook Registration

Summary:

Description:

 

          Properties:

Name

Type

Summary

callbackUrl

string

Callback URL

The URL to call when action occurs.


 

New_Comment_WebHookParameterWebhook Registration

Summary:

Description:

 

          Properties:

Name

Type

Summary

callbackUrl

string

Callback URL

The URL to call when action occurs.


 

Procedure

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Procedure ID

The unique ID of the procedure.

title

string

Procedure Title

The title of the procedure.

status

string

Procedure Status

The publishing status of the procedure.

summary

string

Procedure Summary

The summary of the procedure.

createdBy

string

Created By

The email of the user that created the procedure.

url

string

Procedure URL

The URL of the procedure.

restricted

boolean

Restricted

Wether the procedure is restricted or not.  Values: [, ]

type

integer

Procedure Type

The type of procedure; 1 (standard) or 2 (checklist)  Values: [, ]


 

ProcedureAcceptance

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Acceptance ID

The unique ID of the procedure acceptance

accepted

string(date-time)

Accepted

The date and time the procedure was accepted.

createdBy

string

Accepted By

The email address of the user that accepted the procedure.

fileName

string

PDF File Name

The file name of the generated PDF.

attachmentUrl

string

PDF URL

The URL to the generated PDF. Valid for 5 minutes.

procedureTitle

string

Procedure Title

The title of the accepted procedure.


 

ProcedureAcceptances_GetAllResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

results

array of (ProcedureAcceptance)

Procedure Acceptances

The list of procedure acceptances.

_total

integer(int32)

Total

The total number of procedure acceptances.


 

SecurityRoles_IdTitleResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Security Role ID

The unique id of the security role.

title

string(date-time)

Security Role Title

The title of the security role.


 

TimeZones_GetResponseItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

string

Time Zone ID

The unique ID of the time zone.

title

string

Time Zone Title

The title of the time zone.


 

User

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

User ID

The unique ID of the user.

firstName

string

First Name

The first name of the user.

lastName

string

Last Name

The last name of the user.

email

string

Email

The email address of the user.


 

Users_PostParameterCreate User Command

Summary:

Description:

 

          Properties:

Name

Type

Summary

firstName

string

First Name

The first name of the user.

lastName

string

Last Name

The last name of the user.

email

string

Email

The email address of the user.

securityRole

integer(int32)

Security Role

Select a security role.

companyRoles

array of (integer(int32))

 

 

timeZoneId

string

Time Zone

Select the user's timezone.


 

Users_PostResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary


 

WebhookRegistered

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

Webhook ID

The unique ID of the Webhook registration.

callbackurl

string

Callback URL

The URL to call when action occurs.

created

string(date-time)

Created Date

The date and time the webhook was registered.

webHookEvent

string

Webhook Event

The name of the webhook event.