{"id":307,"date":"2025-03-07T15:15:04","date_gmt":"2025-03-07T15:15:04","guid":{"rendered":"https:\/\/ip1survey.se\/?page_id=307"},"modified":"2026-03-04T12:56:10","modified_gmt":"2026-03-04T12:56:10","slug":"send-survey","status":"publish","type":"page","link":"https:\/\/ip1survey.se\/en\/developer\/send-survey\/","title":{"rendered":"Send survey"},"content":{"rendered":"<h1 class=\"wp-block-heading\" id=\"sending-surveys\">Send surveys<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"endpoints\">Endpoints<\/h2>\n\n\n\n<p>Browse a specific survey's sendings: <code>GET surveys\/{surveyId}\/sendings<\/code> <br>Read a specific survey's sendings: <code>GET surveys\/{surveyId}\/sendings<\/code> <br>Send a specific survey <code>POST surveys\/{surveyId}\/sendings<\/code><\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"request-data-type\">Request Data Type<\/h2>\n\n\n<div class=\"wp-block-syntaxhighlighter-code\"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n{\n  &quot;participants&quot;: &#x5B;\n    &quot;5f806d30591746f32872e96e&quot;\n  ],\n  &quot;newParticipants&quot;: &#x5B;\n    {\n      &quot;phoneNumber&quot;: &quot;46712345678&quot;,\n      &quot;emailAddress&quot;: &quot;test@example.com&quot;,\n      &quot;properties&quot;: {\n        &quot;firstName&quot;: &quot;John&quot;\n      }\n    }\n  ],\n  &quot;channels&quot;: &#x5B;\n    &quot;Sms&quot;,\n    &quot;Email&quot;\n  ],\n  &quot;defaultProperties&quot;: {\n    &quot;firstName&quot;: &quot;&quot;\n  },\n  &quot;deliveryWindows&quot;: &#x5B;\n    {\n      &quot;opens&quot;: &quot;2021-11-12T11:57:12.2013982Z&quot;,\n      &quot;closes&quot;: &quot;2021-11-19T11:57:12.2013982Z&quot;\n    }\n  ],\n  &quot;sms&quot;: {\n    &quot;sender&quot;: &quot;iP1&quot;,\n    &quot;body&quot;: &quot;Survey time {firstName}&quot;\n  },\n  &quot;email&quot;: {\n    &quot;sender&quot;: &quot;iP1&quot;,\n    &quot;senderAddress&quot;: &quot;survey@ip1marketing.com&quot;,\n    &quot;subject&quot;: &quot;Survey time&quot;,\n    &quot;message&quot;: &quot;Here&#039;s the survey&quot;\n  }\n}\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\" id=\"participants\">deltagare<\/h3>\n\n\n\n<p>A collection of IDs for participants in the sending. For inquiries, this is a list of past participants to remind you of.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"newparticipants\">newParticipants<\/h3>\n\n\n\n<p>A collection of data to create new participants. Max 1000. These are converted and moved to participants during processing.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"phonenumber\">phoneNumber<\/h3>\n\n\n\n<p>The phone number to use when sending on the SMS channel.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"emailaddress\">emailAddress<\/h3>\n\n\n\n<p>The email address to use when sending on the email channel.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"properties\">properties<\/h3>\n\n\n\n<p>A dictionary of additional properties that can be used when you template messages. Can also be used to categorize participants and template questions.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"channels\">channels<\/h3>\n\n\n\n<p>Which channels the broadcast should be sent on. Valid values \u200b\u200bare SMS and Email. More may be added in the future. At least one is required, and only participants who have applicable target properties will be sent on specific channels (e.g. phone number for SMS).<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"defaultproperties\">defaultProperties<\/h3>\n\n\n\n<p>Like participant properties but default values \u200b\u200bused when a participant lacks the specific property.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"deliverywindows\">deliveryWindows<\/h3>\n\n\n\n<p>If there is a need to schedule a shipment in the future, there is the option to do so with our delivery time windows.<\/p>\n\n\n\n<p>You can have as many windows as you want. This allows you to send messages at specific times over several days, for example, every day between 10:00 and 10:05 on weekdays.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"parsing\">Parsing<\/h4>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>null<\/code> in the field opened will be replaced with the current date and time.<\/li>\n\n\n\n<li>If <code>closes <\/code>is <code>null <\/code>the field will be set to 7 days (168 hours) after the field is opened<\/li>\n<\/ul>\n\n\n\n<p>The request will be rejected if windows overlap.<\/p>\n\n\n\n<p>If no windows are given, we will create a window that will apply the parsing rule above.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"sms\">sms<\/h3>\n\n\n\n<p>Channel-specific details for the SMS channel.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"email\">email<\/h3>\n\n\n\n<p>Channel-specific information for the email channel.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"sender\">sender<\/h3>\n\n\n\n<p>Sender name\/ID to use for either SMS or email.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"sender\">senderAddress<\/h3>\n\n\n\n<p>Avs\u00e4ndarens e-postadress att anv\u00e4nda f\u00f6r e-postutskick.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">body<\/h3>\n\n\n\n<p>SMS message text. Participant properties can be created as templates using brackets ({}). A special template {url} can be added to place the link to the survey at a specific location in the message. If {url} is not included, it will be added after two line breaks at the end of the message.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"subject\">subject<\/h3>\n\n\n\n<p>The email subject to use in all emails.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"message\">message<\/h3>\n\n\n\n<p>A message to participants that will be included in the emails along with the link to the survey.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"response-data-type\">Response data type<\/h2>\n\n\n<div class=\"wp-block-syntaxhighlighter-code\"><pre class=\"brush: plain; title: ; notranslate\" title=\"\">\n{\n  &quot;id&quot;: &quot;600ade98a11bf89ac18b5d76&quot;,\n  &quot;surveyId&quot;: &quot;5f9028d2d60d0f12d4db4e67&quot;,\n  &quot;status&quot;: &quot;Delivered&quot;,\n  &quot;participants&quot;: &#x5B;\n    &quot;5f806d30591746f32872e96e&quot;,\n    &quot;5f903a70490f3c2d48fea8d3&quot;\n  ],\n  &quot;newParticipants&quot;: &#x5B;],\n  &quot;channels&quot;: &#x5B;\n    &quot;Sms&quot;,\n    &quot;Email&quot;\n  ],\n  &quot;defaultProperties&quot;: {},\n  &quot;deliveryWindows&quot;: &#x5B;\n    {\n      &quot;opens&quot;: &quot;2021-11-12T11:57:12.2013982Z&quot;,\n      &quot;closes&quot;: &quot;2021-11-19T11:57:12.2013982Z&quot;\n    }\n  ],\n  &quot;sms&quot;: {\n    &quot;sender&quot;: &quot;iP1&quot;,\n    &quot;body&quot;: &quot;Survey time {firstName}\\n\\n{url}&quot;,\n    &quot;batchId&quot;: &quot;600ade99e66b6b1fc8aada38&quot;,\n    &quot;pendingParticipants&quot;: &#x5B;],\n    &quot;deliveredParticipants&quot;: &#x5B;\n      &quot;5f806d30591746f32872e96e&quot;,\n      &quot;5f903a70490f3c2d48fea8d3&quot;\n    ],\n    &quot;failedParticipants&quot;: &#x5B;],\n    &quot;status&quot;: &quot;Delivered&quot;\n  },\n  &quot;email&quot;: {\n    &quot;sender&quot;: &quot;iP1&quot;,\n    &quot;subject&quot;: &quot;Survey time&quot;,\n    &quot;message&quot;: &quot;Here&#039;s the survey&quot;,\n    &quot;emailIds&quot;: &#x5B;\n      &quot;2c2d2930b0254b8fb8a834670e7f31ef&quot;,\n      &quot;ec0814ff12074597b6fb73d85f5261c6&quot;\n    ],\n    &quot;pendingParticipants&quot;: &#x5B;],\n    &quot;deliveredParticipants&quot;: &#x5B;\n      &quot;5f806d30591746f32872e96e&quot;,\n      &quot;5f903a70490f3c2d48fea8d3&quot;\n    ],\n    &quot;failedParticipants&quot;: &#x5B;],\n    &quot;status&quot;: &quot;Delivered&quot;\n  }\n}\n\n<\/pre><\/div>\n\n\n<h3 class=\"wp-block-heading\">id<\/h3>\n\n\n\n<p>Sending ID, used to refer to the sending<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"surveyid\">surveyId<\/h3>\n\n\n\n<p>Survey ID of the survey to which the sending belongs.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"status\">status<\/h3>\n\n\n\n<p>The current status of the broadcast or a specific channel. Available statuses include the following.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Status<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>New<\/td><td>The sending has just been created and no processing has started.<\/td><\/tr><tr><td>Pending<\/td><td>The sending has started the first stage of processing, generating participants<\/td><\/tr><tr><td>Ready<\/td><td>The broadcast or channel is ready to be sent.<\/td><\/tr><tr><td>Failed<\/td><td>The broadcast or channel could not be delivered.<\/td><\/tr><tr><td>Sent<\/td><td>The broadcast or channel has been sent but delivery is still unconfirmed<\/td><\/tr><tr><td>Delivered<\/td><td>The broadcast or channel has been delivered in full or externally scheduled<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"batchid\">batchId<\/h3>\n\n\n\n<p>SMS batch ID that refers to sent or scheduled messages on the SMS channel.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"emailids\">emailIds<\/h3>\n\n\n\n<p>Email IDs that refer to sent or scheduled emails on the email channel.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"pendingparticipants\">pendingParticipants<\/h3>\n\n\n\n<p>ID of the channel participant whose message is waiting for delivery.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"deliveredparticipants\">deliveredParticipants<\/h3>\n\n\n\n<p>ID of channel participant whose message delivery has been confirmed or scheduled externally.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"failedparticipants\">failedParticipants<\/h3>\n\n\n\n<p>ID of channel participant whose message could not be delivered.<\/p>","protected":false},"excerpt":{"rendered":"<p>Skicka enk\u00e4ter Endpoints Bl\u00e4ddra en specifik enk\u00e4ts utskick: GET surveys\/{surveyId}\/sendings L\u00e4sa en specifik enk\u00e4ts utskick: GET surveys\/{surveyId}\/sendings Skicka en specifik enk\u00e4t: POST surveys\/{surveyId}\/sendings Anropsdata-typ participants En samling ID:n f\u00f6r deltagare i s\u00e4ndningen. F\u00f6r f\u00f6rfr\u00e5gningar \u00e4r detta en lista \u00f6ver tidigare deltagare att p\u00e5minna om. newParticipants En samling data f\u00f6r att skapa nya deltagare. Max 1000. [&hellip;]<\/p>","protected":false},"author":1,"featured_media":0,"parent":228,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"developer.php","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"class_list":["post-307","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v26.1 (Yoast SEO v26.1.1) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Skicka enk\u00e4t - ip1survey.se<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/ip1survey.se\/en\/developer\/send-survey\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Skicka enk\u00e4t\" \/>\n<meta property=\"og:description\" content=\"Skicka enk\u00e4ter Endpoints Bl\u00e4ddra en specifik enk\u00e4ts utskick: GET surveys\/{surveyId}\/sendings L\u00e4sa en specifik enk\u00e4ts utskick: GET surveys\/{surveyId}\/sendings Skicka en specifik enk\u00e4t: POST surveys\/{surveyId}\/sendings Anropsdata-typ participants En samling ID:n f\u00f6r deltagare i s\u00e4ndningen. F\u00f6r f\u00f6rfr\u00e5gningar \u00e4r detta en lista \u00f6ver tidigare deltagare att p\u00e5minna om. newParticipants En samling data f\u00f6r att skapa nya deltagare. Max 1000. [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/ip1survey.se\/en\/developer\/send-survey\/\" \/>\n<meta property=\"og:site_name\" content=\"ip1survey.se\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/facebook.com\/IP1AB\" \/>\n<meta property=\"article:modified_time\" content=\"2026-03-04T12:56:10+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/\",\"url\":\"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/\",\"name\":\"Skicka enk\u00e4t - ip1survey.se\",\"isPartOf\":{\"@id\":\"http:\/\/ip1survey.se\/en\/#website\"},\"datePublished\":\"2025-03-07T15:15:04+00:00\",\"dateModified\":\"2026-03-04T12:56:10+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/ip1survey.se\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Dokumentation\",\"item\":\"https:\/\/ip1survey.se\/utvecklare\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Skicka enk\u00e4t\"}]},{\"@type\":\"WebSite\",\"@id\":\"http:\/\/ip1survey.se\/en\/#website\",\"url\":\"http:\/\/ip1survey.se\/en\/\",\"name\":\"ip1survey.se\",\"description\":\"\",\"publisher\":{\"@id\":\"http:\/\/ip1survey.se\/en\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"http:\/\/ip1survey.se\/en\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"http:\/\/ip1survey.se\/en\/#organization\",\"name\":\"iP.1 Networks AB\",\"url\":\"http:\/\/ip1survey.se\/en\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"http:\/\/ip1survey.se\/en\/#\/schema\/logo\/image\/\",\"url\":\"http:\/\/ip1survey.se\/wp-content\/uploads\/2025\/03\/ip1-logo-white.svg\",\"contentUrl\":\"http:\/\/ip1survey.se\/wp-content\/uploads\/2025\/03\/ip1-logo-white.svg\",\"width\":1,\"height\":1,\"caption\":\"iP.1 Networks AB\"},\"image\":{\"@id\":\"http:\/\/ip1survey.se\/en\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/facebook.com\/IP1AB\"]}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Skicka enk\u00e4t - ip1survey.se","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/ip1survey.se\/en\/developer\/send-survey\/","og_locale":"en_US","og_type":"article","og_title":"Skicka enk\u00e4t","og_description":"Skicka enk\u00e4ter Endpoints Bl\u00e4ddra en specifik enk\u00e4ts utskick: GET surveys\/{surveyId}\/sendings L\u00e4sa en specifik enk\u00e4ts utskick: GET surveys\/{surveyId}\/sendings Skicka en specifik enk\u00e4t: POST surveys\/{surveyId}\/sendings Anropsdata-typ participants En samling ID:n f\u00f6r deltagare i s\u00e4ndningen. F\u00f6r f\u00f6rfr\u00e5gningar \u00e4r detta en lista \u00f6ver tidigare deltagare att p\u00e5minna om. newParticipants En samling data f\u00f6r att skapa nya deltagare. Max 1000. [&hellip;]","og_url":"https:\/\/ip1survey.se\/en\/developer\/send-survey\/","og_site_name":"ip1survey.se","article_publisher":"https:\/\/facebook.com\/IP1AB","article_modified_time":"2026-03-04T12:56:10+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/","url":"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/","name":"Skicka enk\u00e4t - ip1survey.se","isPartOf":{"@id":"http:\/\/ip1survey.se\/en\/#website"},"datePublished":"2025-03-07T15:15:04+00:00","dateModified":"2026-03-04T12:56:10+00:00","breadcrumb":{"@id":"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/ip1survey.se\/utvecklare\/skicka-enkat\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/ip1survey.se\/"},{"@type":"ListItem","position":2,"name":"API Dokumentation","item":"https:\/\/ip1survey.se\/utvecklare\/"},{"@type":"ListItem","position":3,"name":"Skicka enk\u00e4t"}]},{"@type":"WebSite","@id":"http:\/\/ip1survey.se\/en\/#website","url":"http:\/\/ip1survey.se\/en\/","name":"ip1survey.se","description":"","publisher":{"@id":"http:\/\/ip1survey.se\/en\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"http:\/\/ip1survey.se\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"http:\/\/ip1survey.se\/en\/#organization","name":"iP.1 Networks AB","url":"http:\/\/ip1survey.se\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"http:\/\/ip1survey.se\/en\/#\/schema\/logo\/image\/","url":"http:\/\/ip1survey.se\/wp-content\/uploads\/2025\/03\/ip1-logo-white.svg","contentUrl":"http:\/\/ip1survey.se\/wp-content\/uploads\/2025\/03\/ip1-logo-white.svg","width":1,"height":1,"caption":"iP.1 Networks AB"},"image":{"@id":"http:\/\/ip1survey.se\/en\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/facebook.com\/IP1AB"]}]}},"_links":{"self":[{"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/pages\/307","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/comments?post=307"}],"version-history":[{"count":3,"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/pages\/307\/revisions"}],"predecessor-version":[{"id":464,"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/pages\/307\/revisions\/464"}],"up":[{"embeddable":true,"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/pages\/228"}],"wp:attachment":[{"href":"https:\/\/ip1survey.se\/en\/wp-json\/wp\/v2\/media?parent=307"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}