{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"576c6fae-3dab-4dda-b184-792387dab933","name":"Power2 - API Type 3 (Newline ASP)","description":"## **Overview**\n\nThe scope of this document is to describe the web API (Type 3) for the Power2 system and the functions it exposes.\n\nEach API function has its own URL which extends from following base URL:\n\n{{host}}/{{api_root}}\n\n## **Authentication**\n\nThis API allows two authentication methods: API Secret and JSON Web Tokens (JWT). JWT is recommended and is the the default for Power2SMS accounts that have API Type 3 enabled.\n\nYou can change authentication method by logging into your Power2SMS account and going to the following page: {{host}}/settings/api.\n\n### Authentication via API Secret\n\nEach request should include the account API secret in the `Authorization` header (i.e. as a Bearer token).\n\nYou can verify that your API call authenticates correctly with a simple request to the base URL, for example:\n\n```\nPOST {{api_root}} HTTP/1.0\nHost: {{host}}\nAccept: application/json\nUser-Agent: My API Client\nAuthorization: {{secret}}\n\n ```\n\nA successful response to the above request would be returned as follows:\n\n```\nHTTP/1.1 200 OK\nContent-type: application.json\nServer: MyServer/0.1\n{}\n\n ```\n\nA request that fails due to incorrect account credentials would be returned as follows:\n\n```\nHTTP/1.1 401 Unauthorized\nContent-type: application.json\nServer: MyServer/0.1\n{}\n\n ```\n\n### Authentication via JWT\n\nFirst, make an API POST request to `{{host}}/{{api_root}}/jwt` which will create a new JWT. Note: This API call should be authenticated using your API secret (see above).\n\nSubsequent API calls (i.e. to other endpoints) should then be authenticated by including your JWT in the `Authorization` header (i.e. as a Bearer token).\n\n## **Data Formats**\n\nOnly JSON payloads are accepted.\n\nAll responses are in JSON format.\n\nNote: When the input field expects a UNIX timestamp, the following datetime formats are also supported:\n\n- dd-mm-yyyy\n    \n- dd-mm-yyyy hh:mm:ss\n    \n- yyyy-mm-dd\n    \n- yyyy-mm-dd hh:mm:ss\n    \n\nAll datetime input fields are expected to be in UTC and are returned in UTC.\n\nNote: UK phone numbers can be supplied in E.164 format (i.e. +447730123456) or in national/standard format (i.e. 07730123465) but non-UK phone numbers should always be supplied in E.164 format.\n\n## **Status Codes**\n\nThe following HTTP status codes are returned:\n\n| **Code** | **Description** | **Comments** |\n| --- | --- | --- |\n| 20x | Ok | :) |\n| 401 | Unauthorized | Check your API secret and make sure it is included in the Authorization HTTP header |\n| 404 | Resource not found | Check the URL is correct.  <br>Check the ID (or name) of the resource/record you are trying to operate on. |\n| 405 | Method not allowed | Check if the API endpoint is a GET, POST, PUT, PATCH or DELETE |\n| 422 | Unprocessable content | Check if any required fields are missing.  <br>Check the format of data in your payload |\n| 429 | Too many requests | You have exceeded our API rate limit (25/sec). |\n| 500 | Internal server error | Oh no! Please contact your administrator so we can get this fixed. |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"30098819","team":5830133,"collectionId":"576c6fae-3dab-4dda-b184-792387dab933","publishedId":"2sBXqDrN2Y","public":true,"publicUrl":"https://api-docs-type-3-newline.power2sms.co.uk","privateUrl":"https://go.postman.co/documentation/30098819-576c6fae-3dab-4dda-b184-792387dab933","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2026-04-16T20:45:46.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":null,"logoDark":null}},"statusCode":200},"environments":[{"name":"P2 (API Type 3) - *** Online Docs *** (Newline ASP)","id":"061ed9c2-ccc7-49f2-82f3-4a27f71aa26c","owner":"30098819","values":[{"key":"host","value":"https://newline.power2sms.co.uk","enabled":true,"type":"default"},{"key":"api_root","value":"api/3/v1","enabled":true,"type":"default"},{"key":"username","value":"myusername","enabled":true,"type":"default"},{"key":"secret","value":"n8R2N5cL0JLd9NSG","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/e2ab4081250cec86d88abf4e68e02a65d16d8fa4e8c46e59c5ba05a72adf74f8","favicon":"https://power2sms.co.uk/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"P2 (API Type 3) - *** Online Docs *** (Newline ASP)","value":"30098819-061ed9c2-ccc7-49f2-82f3-4a27f71aa26c"}],"canonicalUrl":"https://api-docs-type-3-newline.power2sms.co.uk/view/metadata/2sBXqDrN2Y"}