Create traveller journey

Adds a traveller to a specific journey. If the traveller does not exist as a company traveller, they will be automatically created and then subsequently added to the journey.

Create traveller journey

Create a new journey for traveller

post

v1/traveller-journeys/

Authorizations

Body

multipart/form-dataapplication/json

idstringrequired

short_idstring · max: 255 | nullable

journeystringrequired

emailstring · emailrequired

namestring

phonestring

supervisorstring | nullable

date_startstring · date

progressnumber · doublerequired

statusstringrequired

picturestring · uri

sourcestring

source_descriptionstring

Responses

application/json

application/json

201

400

401

201

{
  "id": "9rKdez72",
  "shortId": "9rKdez72",
  "name": "Just Better",
  "phone": null,
  "journey": "6mK7AyZV",
  "dateStart": "2023-01-01",
  "progress": 1,
  "status": "not_started",
  "email": "[e-mail]",
  "picture": null,
  "source": "Manually added",
  "source_description": null,
  "supervisor": {
    "email": "[e-mail]",
    "isActive": true,
    "name": "Phil Jackson",
    "role": "admin",
    "shortId": "7x89X78y"
  },
  "actions": [
    {
      "shortId": "AYGpl0Go",
      "action": "journey_start",
      "description": null,
      "values": null,
      "isAutomatic": false,
      "isComplete": false,
      "parentAction": null,
      "savedValues": null,
      "data": null,
      "result": null
    },
    {
      "short_id": "8oz3MlGp",
      "action": "send_sms",
      "description": "Send sms to traveller",
      "isAutomatic": false,
      "isComplete": false,
      "parentAction": "AYGpl0Go",
      "savedValues": null,
      "result": null,
      "data": {
        "message": "Sms message to traveller",
        "recipients": [
          "[phone]"
        ]
      },
      "values": {
        "message": {
          "value": "Sms message to traveller"
        },
        "recipients": [
          {
            "value": "[phone]"
          }
        ]
      }
    }
  ]
}

Request samples

Application/JSON

{
   "journey":"8oz3gXzp",
   "email":"[e-mail]",
   "name":"Pippin Took",
   "phone":"[phone]",
   "journey_attribute__nLzNOaye":"2024-11-16",
   "source":"Manually added"
}

Python

import requests
response = requests.post(
    "https://journeys-api.50skills.app/v1/traveller-journeys/",
    json={
        "journey": "8oz3gXzp",
        "email": "[e-mail]",
        "name": "Pippin Took",
        "phone": "[phone]",
        "journey_attribute__nLzNOaye": "2024-11-16",
        "source": "Manually added"
        ],
    }
)
print(response.json())               

Response samples

201 (Created)

{
   "id":"AOyeJ4GX"
}