The MLP Integrations API is a set of HTTP endpoints that help your app integrate with MLP Integrations.
\nBase URLs
\nProduction URL : https://api-prod.mylondonpharmacy.co.uk
Staging URL : https://api-staging.mylondonpharmacy.co.uk
Create access token usind clientId and clientSecret. Every token expire in 10 minutes.
\nAll requests to the MLP API must include Bearer token in the Authorization header.
\n","urlObject":{"path":["partner","auth","token"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"7399977f-85b0-4718-a673-9859aef367d0","name":"Create Auth Token","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"clientId\": \"d9e6a7cf28d3ea5f11b00937\",\r\n \"clientSecret\": \"19c60bf2b58e185809f94ab97d9d4a534da400ecdf108ee53109102f8ab59738\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/partner/auth/token"},"status":"Created","code":201,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"\",\n \"data\": {\n \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJvcmdhbml6YXRpb24iOiJCQVNLIiwidHlwZSI6ImNsaWVudCIsImlhdCI6MTc2NjM4NDg1NSwiZXhwIjoxNzY2Mzg1NDU1fQ.vHEUjVQZZxIAOHw1K5LXREhIMZf88HMSijeIL7z52VQ\",\n \"token_type\": \"Bearer\",\n \"expires_in\": 600000\n }\n}"}],"_postman_id":"3a41fc7a-1f16-4cf0-a955-b2f228b87f05"}],"id":"b4bb1bda-5700-4b62-92b2-ec5b0c64868e","_postman_id":"b4bb1bda-5700-4b62-92b2-ec5b0c64868e","description":""},{"name":"Patient","item":[{"name":"Create Patient","id":"0c0017f6-125e-4204-8417-bed5c22bf9ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new patient.
\nPAYLOAD
\n","urlObject":{"path":["partner","patients"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"4b2fb188-195b-4894-820d-bf89066ba69d","name":"Create Patient","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"first_name\": \"Honry\",\r\n \"last_name\": \"Rozer\",\r\n \"email\": \"honry@gmail.com\",\r\n \"phone\": \"+447453553062\",\r\n \"gender\": \"male\",\r\n \"dob\": \"1991-01-01\",\r\n \"identityVerification\": {\r\n \"verification\": \"123456789\",\r\n \"provider\": \"stripe\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/partner/patients"},"status":"Created","code":201,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"The Patient has been created.\",\n \"data\": {\n \"first_name\": \"Honry\",\n \"last_name\": \"Rozer\",\n \"email\": \"honry@gmail.com\",\n \"gender\": \"male\",\n \"phone\": \"+447453553062\",\n \"dob\": \"1991-01-01T00:00:00.000Z\",\n \"patientId\": \"pat_smqhozicjb\"\n }\n}"}],"_postman_id":"0c0017f6-125e-4204-8417-bed5c22bf9ce"},{"name":"Get Patient","id":"39c5b2c9-0210-4d12-b3ae-21ba3d45954b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get patient details.
\n","urlObject":{"path":["partner","patients",":patientId"],"host":["{{baseURL}}"],"query":[],"variable":[{"description":{"content":"Required
\n","type":"text/plain"},"type":"any","value":"{{patientId}}","key":"patientId"}]}},"response":[{"id":"d4cbe8e6-e99b-467f-acee-8093499ea393","name":"Get Patient","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseURL}}/partner/patients/:patientId","host":["{{baseURL}}"],"path":["partner","patients",":patientId"],"variable":[{"key":"patientId","value":"pat_smqhozicjb","description":"Required"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"\",\n \"data\": {\n \"first_name\": \"Honry\",\n \"last_name\": \"Rozer\",\n \"email\": \"honry@gmail.com\",\n \"role\": \"user\",\n \"gender\": \"male\",\n \"phone\": \"+447453553062\",\n \"dob\": \"1991-01-01T00:00:00.000Z\",\n \"createdAt\": \"2025-12-22T06:36:20.460Z\",\n \"updatedAt\": \"2025-12-22T06:36:20.460Z\",\n \"patientId\": \"pat_smqhozicjb\"\n }\n}"}],"_postman_id":"39c5b2c9-0210-4d12-b3ae-21ba3d45954b"},{"name":"Update Patient","id":"cb5ca5a8-4eac-4c03-afdf-159635c21e9b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Update patient details.
\nPAYLOAD
\n","urlObject":{"path":["partner","patients",":patientId"],"host":["{{baseURL}}"],"query":[],"variable":[{"description":{"content":"Required
\n","type":"text/plain"},"type":"any","value":"{{patientId}}","key":"patientId"}]}},"response":[{"id":"1ae610fb-9ff9-4d09-bf83-d9d48f97bbb8","name":"Update Patient","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"last_name\": \"Rozar\"\r\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{baseURL}}/partner/patients/:patientId","host":["{{baseURL}}"],"path":["partner","patients",":patientId"],"variable":[{"key":"patientId","value":"pat_smqhozicjb","description":"Required"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"Updated Successfully.\",\n \"data\": {\n \"first_name\": \"Honry\",\n \"last_name\": \"Rozar\",\n \"email\": \"honry@gmail.com\",\n \"gender\": \"male\",\n \"phone\": \"+447453553062\",\n \"dob\": \"1991-01-01T00:00:00.000Z\",\n \"patientId\": \"pat_smqhozicjb\"\n }\n}"}],"_postman_id":"cb5ca5a8-4eac-4c03-afdf-159635c21e9b"}],"id":"7f0f54c3-be38-45f4-ac91-f54e7e97e0ea","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"cef67a1b-5978-42b5-8676-124df9457d78","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"68bc93b0-3884-4cd7-8140-268ced3035cd","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"7f0f54c3-be38-45f4-ac91-f54e7e97e0ea","description":""},{"name":"Consultation","item":[{"name":"Create Consultation","id":"c396f171-ef95-45c8-b4b9-e88397b37a59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new consultation.
\nPAYLOAD
\nQuestion Properties
\n","urlObject":{"path":["partner","consultations"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"5deb4214-2d5b-462c-8ca3-9e9d1e21217a","name":"Create Consultation","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"patientId\": \"pat_smqhozicjb\",\r\n \"consultationId\": \"cons_weightloss\",\r\n \"productId\": \"Mounjaro_2.5mg_1_Pen\",\r\n \"quantity\": 1,\r\n \"answers\": [\r\n {\r\n \"questionId\": \"ques_lacojdxaex\",\r\n \"ans\": [\r\n \"Male\"\r\n ]\r\n },\r\n {\r\n \"questionId\": \"ques_nxtsjtrocp\",\r\n \"ans\": \"Yes\"\r\n },\r\n {\r\n \"questionId\": \"ques_xhmpsjxbfn\",\r\n \"ans\": \"Yes\"\r\n },\r\n {\r\n \"questionId\": \"ques_bbzgjjomvp\",\r\n \"ans\": \"25\"\r\n },\r\n {\r\n \"questionId\": \"ques_ihcxwozhrj\",\r\n \"ans\": \"45\"\r\n },\r\n {\r\n \"questionId\": \"ques_hdishrftlr\",\r\n \"ans\": \"yes\"\r\n },\r\n {\r\n \"questionId\": \"ques_osdbxvrocp\",\r\n \"ans\": [\r\n \"Other ethnic group\"\r\n ]\r\n },\r\n {\r\n \"questionId\": \"ques_knhyfrcvghb\",\r\n \"ans\": [\r\n \"Normal (between 90/60 ad 140/90)\"\r\n ]\r\n },\r\n {\r\n \"questionId\": \"ques_osmdhvrocp\",\r\n \"ans\": \"Check\"\r\n },\r\n {\r\n \"questionId\": \"ques_ayckzkhihn\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_jhtcfvgdrtf\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_njbgucdesx\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_uhbedcfghy\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_mjyghvtrfg\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_ybrcpfvous\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_ptnkqzwpuy\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_qrfbuklbxg\",\r\n \"ans\": \"yes\"\r\n },\r\n {\r\n \"questionId\": \"ques_sxdeimtqbr\",\r\n \"ans\": \"no\"\r\n },\r\n {\r\n \"questionId\": \"ques_rrmyrrsmes\",\r\n \"ans\": \"file_udhynlmbvm\"\r\n },\r\n {\r\n \"questionId\": \"ques_nlcpdbdcqe\",\r\n \"ans\": \"yes\"\r\n },\r\n {\r\n \"questionId\": \"ques_fgtvhrfcvg\",\r\n \"ans\": \"file_nbgfcenqyr\"\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/partner/consultations"},"status":"Created","code":201,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"The Consultation has been created.\",\n \"data\": {\n \"id\": \"cres_mphcpzztpv\",\n \"status\": \"InReview\"\n }\n}"}],"_postman_id":"c396f171-ef95-45c8-b4b9-e88397b37a59"},{"name":"Get Consultation","id":"af7b0fdf-2ac7-4d86-938d-de27e05097af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Get consultation details.
\n","urlObject":{"path":["consultations",":consultationResponseId"],"host":["{{baseURL}}partner"],"query":[],"variable":[{"description":{"content":"Required
\n","type":"text/plain"},"type":"any","value":"{{consultationResponseId}}","key":"consultationResponseId"}]}},"response":[{"id":"496716a1-8f16-4083-8862-d34a478025ba","name":"Get Consultation","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{baseURL}}/partner/consultations/:consultationResponseId","host":["{{baseURL}}"],"path":["partner","consultations",":consultationResponseId"],"variable":[{"key":"consultationResponseId","value":"cres_mphcpzztpv"}]}},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"\",\n \"data\": {\n \"id\": \"cres_mphcpzztpv\",\n \"status\": \"InReview\"\n }\n}"}],"_postman_id":"af7b0fdf-2ac7-4d86-938d-de27e05097af"}],"id":"38257e19-e18e-4e96-9d34-1922b6b3c84a","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"411c9598-3cfe-4a42-8f4b-f1f5f602312b","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"8fe3b09f-746e-4e56-8969-e1fea3a1eb65","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"38257e19-e18e-4e96-9d34-1922b6b3c84a","description":""},{"name":"Order","item":[{"name":"Create Order","id":"617c46a2-9211-4987-9a77-17eb0a4783cb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new order.
\nPAYLOAD
\n","urlObject":{"path":["partner","orders"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"03251799-1ade-4f95-8290-c50deb733e6b","name":"Create Order","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"patientId\": \"pat_smqhozicjb\",\r\n \"consultationResponseId\": \"cres_mphcpzztpv\",\r\n \"shippingInformation\": {\r\n \"address_line1\": \"18 Oniseg\",\r\n \"address_line2\": \"Zintol\",\r\n \"city\": \"London\",\r\n \"zip_code\": \"123456\",\r\n \"country\": \"United Kingdom\",\r\n \"country_code\": \"GB\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"{{baseURL}}/partner/orders"},"status":"Created","code":201,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"The Order has been created.\",\n \"data\": {\n \"id\": \"ord_mljcleocql\"\n }\n}"}],"_postman_id":"617c46a2-9211-4987-9a77-17eb0a4783cb"}],"id":"11340c3e-9336-40a9-8b07-eba7d3180de7","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"fd9b4e22-8993-4fa4-aba4-2d4d9d53dbf5","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"b86d3f03-5af8-47d8-b2ed-b1cb47c19d2a","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"11340c3e-9336-40a9-8b07-eba7d3180de7","description":""},{"name":"File","item":[{"name":"Create File","id":"3e4f7c0e-0c81-4e6c-b335-a8112ed17e70","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"Creates a new file.
\n","urlObject":{"path":["partner","files","image"],"host":["{{baseURL}}"],"query":[],"variable":[]}},"response":[{"id":"1f5591e1-b7f4-4c59-b68e-74618f161f91","name":"Create File","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","uuid":"1597cc24-fa49-452b-ba87-a689154f2991","value":null}]},"url":"{{baseURL}}/partner/files/image"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"message\": \"File uploded.\",\n \"data\": {\n \"fileId\": \"file_dlbonumrcl\"\n }\n}"}],"_postman_id":"3e4f7c0e-0c81-4e6c-b335-a8112ed17e70"}],"id":"31ad2891-83c4-4a55-94d6-ce0c797891a7","auth":{"type":"noauth","isInherited":false},"event":[{"listen":"prerequest","script":{"id":"500d2533-f76c-4403-9a78-64097316b6b5","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"698c44a3-00b3-4a8b-9c03-c870e1a9d6cb","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"_postman_id":"31ad2891-83c4-4a55-94d6-ce0c797891a7","description":""},{"name":"Webhooks","item":[{"name":"Consultation Approved","id":"ca456c7c-bc63-488e-adb1-b4938dc3c0e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/jose","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"event\": \"consultation_approved\",\r\n \"data\": {\r\n \"consultationResponseId\": \"cres_mphcpzztpv\",\r\n \"status\": \"approved\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://webhook.site","urlObject":{"protocol":"https","host":["webhook","site"],"query":[],"variable":[]}},"response":[],"_postman_id":"ca456c7c-bc63-488e-adb1-b4938dc3c0e7"},{"name":"Consultation Rejected","id":"d9eb8721-3ea1-4c5f-82f9-718ecb110da0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/jose","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"event\": \"consultation_rejected\",\r\n \"data\": {\r\n \"consultationResponseId\": \"cres_mphcpzztpv\",\r\n \"status\": \"rejected\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://webhook.site","urlObject":{"protocol":"https","host":["webhook","site"],"query":[],"variable":[]}},"response":[],"_postman_id":"d9eb8721-3ea1-4c5f-82f9-718ecb110da0"},{"name":"Order Dispatched","id":"075e08b9-a10a-461c-b310-276ed411dbc4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/jose","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"event\": \"order_dispatched\",\r\n \"data\": {\r\n \"orderId\": \"ord_mljcleocql\",\r\n \"trackingNumber\": \"123456789\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://webhook.site","urlObject":{"protocol":"https","host":["webhook","site"],"query":[],"variable":[]}},"response":[],"_postman_id":"075e08b9-a10a-461c-b310-276ed411dbc4"},{"name":"Order Cancelled","id":"09505ff5-bc16-4c31-b2d8-9d7981d13594","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/jose","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"event\": \"order_cancelled\",\r\n \"data\": {\r\n \"orderId\": \"ord_mljcleocql\",\r\n \"cancelled_reason\": \"Cancelled reason\"\r\n }\r\n}","options":{"raw":{"language":"json"}}},"url":"https://webhook.site","urlObject":{"protocol":"https","host":["webhook","site"],"query":[],"variable":[]}},"response":[],"_postman_id":"09505ff5-bc16-4c31-b2d8-9d7981d13594"}],"id":"63ae7eb4-9d3b-4295-8ea8-b7d9ed947d69","description":"Webhook Events
\nOur API will send information to your application about events that occur on the platform.
\nEvents are sent as Signed JSON Web Tokens (JWS) via a HTTPS POST request. They will be sent with the Content-Type: application/jose header.
You must verify the JWT signature using the secret you will have been issued when the webhook is registered to your account. This guarantees the webhook was received from MLP and has not been tampered with.
\nOnce the signature is verified you can safely decode & parse the payload as a JSON object. Example decoded payloads are documented below.
\nWebhook EventsAcknowledging Webhook Events
\nAfter a webhook event has been received, it must be acknowledged by responding with a successful (2XX) status code. Events which are not acknowledged with a successful status code will be resent up to 5 times, in an attempt to ensure that the event is received successfully.