¶ Use case

Use this endpoint to create a communication session for a given trip.

This endpoint will return a phone number that will proxy voice and sms communications between the trip driver and the recipient.

The recipient phone number could be the rider or the organization.

The provisioned phone number is only valid until the trip completes, it will not work after the trip completes.

Only one session can exist for a trip.

If this endpoint is called twice with two different phone numbers, the first session will be invalidated after the second request and only the second input phone number will be able to contact the output phone number.

If the request is from a third party (3P) app, please add x-uber-organizationuuid header and the Organization UUID as the value or the request will be denied.

¶ Authorization

OAuth 2.0 Bearer token with the guests.trips scope.

¶ Request

¶ Example request

curl -X POST \
  -H "authorization: Bearer <access_token>" \
  -H 'content-type: application/json' \
  -d '{
        "phone_number": "+14155551234"
      }' \
      'https://api.uber.com/v1/guests/trips/<request_id>/communication'

¶ Request URL parameters

¶ Request body parameters

¶ Response

¶ Example response

{
  "phone_number": "+14155554321"
}

¶ Response body parameters

¶ Expected Errors

{
  "message": "Participant creation rejected due to possible duplication across sessions",
  "data": {
    "statusCode": "400"
  },
  "errCode": "bad_request"
}