API Reference

Connect Airbnb

Connect

Request: POST /connections?appId=airbnb

Body:

Use appropriate locale (e.g. "fr" / "de" / ...)

{
  "email": "[email protected]",
  "password": "password123",
  "locale": "gb"
}

Possible Responses

  • Response A (Captcha challenge)
  • Response B (PinCode challenge)
  • Response C (Success)
  • Response { type: "issue", code: "INVALID_CREDENTIALS" } => wrong email/password

Response A (Captcha challenge):

{
  "type": "issue",
  "message": "Please solve the provided captcha.",
  "code": 'CAPTCHA_FLOW',
  "state": {
    "sessionKey": "b32cfff7-75c6-4e36-b7ec-0ee9cb2c62c1",
    "expiresIn": 259200
  },
  "action": {
    "link": "https://www.airbnb.com/airlock?al_id=-6075732846789269"
  }
}

Actions

  • Retry connecting, we will likely able to succeed on a second try
  • Manually open the captcha with the link provided in action.link and solve the captcha
  • Wait a few hours and try again

Response B (PinCode challenge):

{
  "type": "issue",
  "code": 'EMAIL_CODE_VERIFICATION',
  "message": "Please enter security code sent to your email address",
  "state": {
    "sessionKey": "02721e9e-7cbd-41a5-a9e3-78dea2ad588c",
    "expiresIn": 259200
  },
  "action": {
    "type": "form",
    "fields": {
      "pinCode": {
        "type": "text",
        "label": "PIN"
      }
    }
  }
}

Actions

  • Submit pincode verification

POST /connections?appId=airbnb&sessionKey=f3a8dd3b-aa94-4772-840c-38e009e3ad20"

{
  "pinCode": "your-pin-code"
}

Possible Responses

  • Response C (Success)
  • Response { type: "issue", code: "INVALID_CODE" }

Response C (Success):

{
  "id": "f3a8dd3b-aa94-4772-840c-38e009e3ad20"
}

Actions

  • None, the connection with id f3a... should be visible in the dashboard.