/surveys/templates

Changed on

Creates a survey master template for the account. Required scope: w_surveys. Requires a user token whose member has permission to manage survey templates, or an account token with the member_id of such a member; an account token without member_id gets 403. Send member_id as a query parameter, not in the body. The account must have the Surveys feature enabled. The body is validated before authorization.

position is auto-assigned when omitted. type, semantic_type and navigation rule type accept snake_case or PascalCase/camelCase. Unknown keys are rejected. The response is returned in snake_case.

post/surveys/templates

Request

  • Base URL
    https://subdomain.workable.com/spi/v3
  • URL
    https://subdomain.workable.com/spi/v3/surveys/templates
  • Auth
    API key in header Authorization

Query parameters

member_idstring

Required when using an account token: the member (SPI key, from GET /members) to act as. The request is evaluated with that member's permissions; without it the request gets 403. Ignored for user tokens. Must be sent as a query parameter, not in the body.

Request body

titlestring required

Title of the template

Response

201

idstring
titlestring
updated_atstring date-time

Omitted when unknown

versioninteger
defaultboolean
sampleboolean
disabledboolean

Changes