Connectors Reference

Motimate

Motimate is the result of more than 10 years of working with some of Scandinavias largest companies in improving their internal communication, increasing their sales and refining their employee training. We provide an award winning SAAS-solution making internal communication and corporate training fun and easy.  Read more about Motimate on motimateapp.com.

 

Status: Preview

Tier: Premium

Version: 1.0.0

 

Actions:

Name

Summary

User_GetAll (string Auth, string subdomain)

User - get all

User_Create (string Auth, string subdomain, User_CreateParameterBody body)

User - create

User_GetById (string user_id, string Auth, string subdomain)

User - Get by id

User_DeleteById (string user_id, string Auth, string subdomain)

User - delete by id

User_UpdateById (string user_id, string Auth, string subdomain, [Optional]User_UpdateByIdParameterBody body)

User - update by id

Position_GetAll (string Auth, string subdomain)

Position - get all

Position_Create (string Auth, string subdomain, array body)

Position - create

Position_GetById (string Auth, string subdomain, string position_id)

Position - get by id

Position_DeleteById (string Auth, string subdomain, string position_id)

DELETE positions

Position_UpdateById (string position_id, string Auth, string subdomain, [Optional]Position_UpdateByIdParameterBody body)

Position - update by id

Group_GetAll (string Auth, string subdomain)

Group - get all

Group_Create (string Auth, string subdomain, array body)

Group - create

Group_GetById (string Auth, string subdomain, string group_id)

Group - get by id

Group_DeleteById (string Auth, string subdomain, string group_id)

Group - delete by id

Group_UpdateById (string group_id, string Auth, string subdomain, [Optional]Group_UpdateByIdParameterBody body)

Group - Update by id

Token_Get (string subdomain, [internal]string grant_type, string username, string password, string client_id)

POST token

_me (string Auth, string subdomain)

GET me

 

Triggers:

Name

Summary

 

Objects:

Name

Summary

Group_CreateParameterBodyItem

 

Group_CreateResponse

 

Group_DeleteByIdResponse

 

Group_GetAllResponse

 

Group_GetByIdResponse

 

Group_UpdateByIdParameterBody

 

Group_UpdateByIdResponse

 

Position_CreateParameterBodyItem

 

Position_CreateResponse

 

Position_DeleteByIdResponse

 

Position_GetAllResponse

 

Position_GetByIdResponse

 

Position_UpdateByIdParameterBody

 

Position_UpdateByIdResponse

 

Token_GetResponse

 

User_CreateParameterBody

 

User_CreateResponse

 

User_DeleteByIdResponse

 

User_GetAllResponse

 

User_GetByIdResponse

 

User_UpdateByIdParameterBody

 

User_UpdateByIdResponse

 

_meResponse

 

 

Actions:

User_GetAll

Summary: User - get all

Description: Get  all users in organization

 

Syntax:

Motimate.User_GetAll (string Auth, string subdomain)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

 

Returns:

          Type:User_GetAllResponse

 

User_Create

Summary: User - create

Description: Create new user

 

Syntax:

Motimate.User_Create (string Auth, string subdomain, User_CreateParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

body

User_CreateParameterBody

 

 

True

 

Returns:

          Type:User_CreateResponse

 

User_GetById

Summary: User - Get by id

Description: Get user by user_id

 

Syntax:

Motimate.User_GetById (string user_id, string Auth, string subdomain)

 

Parameters:

Name

Type

Summary

Required

Related Action

user_id

string

(User id)

User ID in Motimate

True

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

 

Returns:

          Type:User_GetByIdResponse

 

User_DeleteById

Summary: User - delete by id

Description: Delete user by user_id

 

Syntax:

Motimate.User_DeleteById (string user_id, string Auth, string subdomain)

 

Parameters:

Name

Type

Summary

Required

Related Action

user_id

string

(User id)

User ID in Motimate

True

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

 

Returns:

          Type:User_DeleteByIdResponse

 

User_UpdateById

Summary: User - update by id

Description: Update user by user_id

 

Syntax:

Motimate.User_UpdateById (string user_id, string Auth, string subdomain, [Optional]User_UpdateByIdParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

user_id

string

(User id)

User ID in Motimate

True

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

body

User_UpdateByIdParameterBody

 

 

False

 

Returns:

          Type:User_UpdateByIdResponse

 

Position_GetAll

Summary: Position - get all

Description: Get all positions in organization

 

Syntax:

Motimate.Position_GetAll (string Auth, string subdomain)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

 

Returns:

          Type:Position_GetAllResponse

 

Position_Create

Summary: Position - create

Description: Create new position

 

Syntax:

Motimate.Position_Create (string Auth, string subdomain, array body)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

body

array of (Position_CreateParameterBodyItem)

 

 

True

 

Returns:

          Type:Position_CreateResponse

 

Position_GetById

Summary: Position - get by id

Description: Get position by position_id

 

Syntax:

Motimate.Position_GetById (string Auth, string subdomain, string position_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

position_id

string

(Position id)

Position ID in Motimate

True

 

Returns:

          Type:Position_GetByIdResponse

 

Position_DeleteById

Summary: DELETE positions

Description: Delete position by position_id

 

Syntax:

Motimate.Position_DeleteById (string Auth, string subdomain, string position_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

position_id

string

(Position id)

Position ID in Motimate

True

 

Returns:

          Type:Position_DeleteByIdResponse

 

Position_UpdateById

Summary: Position - update by id

Description: Update position by position_id

 

Syntax:

Motimate.Position_UpdateById (string position_id, string Auth, string subdomain, [Optional]Position_UpdateByIdParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

position_id

string

(Position id)

Position ID in Motimate

True

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

body

Position_UpdateByIdParameterBody

 

 

False

 

Returns:

          Type:Position_UpdateByIdResponse

 

Group_GetAll

Summary: Group - get all

Description: Get all groups

 

Syntax:

Motimate.Group_GetAll (string Auth, string subdomain)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

 

Returns:

          Type:Group_GetAllResponse

 

Group_Create

Summary: Group - create

Description: Create new group

 

Syntax:

Motimate.Group_Create (string Auth, string subdomain, array body)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

body

array of (Group_CreateParameterBodyItem)

 

 

True

 

Returns:

          Type:Group_CreateResponse

 

Group_GetById

Summary: Group - get by id

Description: Get group by group_id

 

Syntax:

Motimate.Group_GetById (string Auth, string subdomain, string group_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

group_id

string

(Group id)

Group ID in Motimate

True

 

Returns:

          Type:Group_GetByIdResponse

 

Group_DeleteById

Summary: Group - delete by id

Description: Delete group by group_id

 

Syntax:

Motimate.Group_DeleteById (string Auth, string subdomain, string group_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

group_id

string

(Group id)

Group ID in Motimate

True

 

Returns:

          Type:Group_DeleteByIdResponse

 

Group_UpdateById

Summary: Group - Update by id

Description: Update group by group_id

 

Syntax:

Motimate.Group_UpdateById (string group_id, string Auth, string subdomain, [Optional]Group_UpdateByIdParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

group_id

string

(Group id)

Group ID in Motimate

True

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

body

Group_UpdateByIdParameterBody

 

 

False

 

Returns:

          Type:Group_UpdateByIdResponse

 

Token_Get

Summary: POST token

Description: Get oauth token

 

Syntax:

Motimate.Token_Get (string subdomain, [internal]string grant_type, string username, string password, string client_id)

 

Parameters:

Name

Type

Summary

Required

Related Action

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

grant_type

string(password)

(Grant type)

Type of authentication

True

username

string

(Username)

Admin user in Motimate

True

password

string(password)

(Password)

Admin password in Motimate

True

client_id

string(password)

(Client id)

Application client ID (provided by Motimate)

True

 

Returns:

          Type:Token_GetResponse

 

_me

Summary: GET me

Description: Me

 

Syntax:

Motimate._me (string Auth, string subdomain)

 

Parameters:

Name

Type

Summary

Required

Related Action

Auth

string

(Authorization)

Authorization with access token (Format: "Bearer " + {access_token})

True

subdomain

string

(Subdomain)

Specify your organization's subdomain to motimateapp.com.

True

 

Returns:

          Type:_meResponse

 


 

Group_CreateParameterBodyItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

key

string

 

key

value

string

 

value

description

string

 

description

type

string

 

type

enabled

boolean

 

enabled


 

Group_CreateResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

kind

string

 

kind

level

string

 

level

name

string

 

name

parent_id

integer(int32)

 

parent_id

 


 

Group_DeleteByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary


 

Group_GetAllResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

array of (DataItem)

 

data

 

DataItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

kind

string

 

kind

level

string

 

level

name

string

 

name

parent_id

integer(int32)

 

parent_id

 


 

Group_GetByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

kind

string

 

kind

level

string

 

level

name

string

 

name

 


 

Group_UpdateByIdParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

kind

string

 

kind

name

string

 

name


 

Group_UpdateByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

kind

string

 

kind

level

string

 

level

name

string

 

name

 


 

Position_CreateParameterBodyItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

key

string

 

key

value

string

 

value

description

string

 

description

type

string

 

type

enabled

boolean

 

enabled


 

Position_CreateResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

import_id

string

 

import_id

name

string

 

name

 


 

Position_DeleteByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary


 

Position_GetAllResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

array of (DataItem)

 

data

 

DataItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

import_id

string

 

import_id

name

string

 

name

 


 

Position_GetByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

import_id

string

 

import_id

name

string

 

name

 


 

Position_UpdateByIdParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

import_id

string

 

import_id

name

string

 

name


 

Position_UpdateByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

import_id

string

 

import_id

name

string

 

name

 


 

Token_GetResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

access_token

string

 

access_token

created_at

integer(int32)

 

created_at

expires_in

integer(int32)

 

expires_in

refresh_token

string

 

refresh_token

token_type

string

 

token_type


 

User_CreateParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

email

string

 

email

employee_number

string

 

employee_number

first_name

string

 

first_name

last_name

string

 

last_name

phone_number

string

 

phone_number

organization_role

string

 

organization_role  Values: [normal_user, organization_admin, pulse_editor, training_editor]

group_relations

array of (Group_relationsItem)

 

group_relations

position_relations

array of (Position_relationsItem)

 

position_relations

 

Group_relationsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

 

Position_relationsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

 


 

User_CreateResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

email

string

 

email

employee_number

string

 

employee_number

first_name

string

 

first_name

id

integer(int32)

 

id

last_name

string

 

last_name

phone_number

string

 

phone_number

organization_role

string

 

organization_role

groups

array of (GroupsItem)

 

groups

positions

array of (PositionsItem)

 

positions

 

GroupsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

groups.id

kind

string

 

kind

level

string

 

level

name

string

 

name

 

PositionsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

positions.id

name

string

 

name

 


 

User_DeleteByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary


 

User_GetAllResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

array of (DataItem)

 

data

 

DataItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

email

string

 

email

employee_number

string

 

employee_number

first_name

string

 

first_name

last_name

string

 

last_name

phone_number

string

 

phone_number

organization_role

string

 

organization_role

 


 

User_GetByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

email

string

 

email

employee_number

string

 

employee_number

first_name

string

 

first_name

id

integer(int32)

 

id

last_name

string

 

last_name

phone_number

string

 

phone_number

organization_role

string

 

organization_role

groups

array of (GroupsItem)

 

groups

positions

array of (PositionsItem)

 

positions

 

GroupsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

groups.id

kind

string

 

groups.kind

level

string

 

groups.level

name

string

 

groups.name

 

PositionsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

positions.id

name

string

 

positions.name

 


 

User_UpdateByIdParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

email

string

 

email

first_name

string

 

first_name

last_name

string

 

last_name

phone_number

string

 

phone_number

organization_role

string

 

organization_role

group_relations

array of (Group_relationsItem)

 

group_relations

position_relations

array of (Position_relationsItem)

 

position_relations

 

Group_relationsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

_delete

boolean

 

_delete

group_id

integer(int32)

 

group_id

role

string

 

role

 

Position_relationsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

_delete

boolean

 

_delete

position_id

integer(int32)

 

position_id

 


 

User_UpdateByIdResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

email

string

 

email

employee_number

string

 

employee_number

first_name

string

 

first_name

id

integer(int32)

 

id

last_name

string

 

last_name

phone_number

string

 

phone_number

organization_role

string

 

organization_role

groups

array of (GroupsItem)

 

groups

positions

array of (PositionsItem)

 

positions

 

GroupsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

groups.id

kind

string

 

groups.kind

level

string

 

groups.level

name

string

 

groups.name

 

PositionsItem

Summary:

Description:

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

positions.id

name

string

 

positions.name

 


 

_meResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

data

Data

 

data

 

Data

Summary:

Description: data

 

          Properties:

Name

Type

Summary

id

integer(int32)

 

id

email

string

 

email

employee_number

string

 

employee_number

first_name

string

 

first_name

last_name

string

 

last_name

organization_role

string

 

organization_role

phone_number

string

 

phone_number