Create Connection

POST /haulers/{hauler_uuid}/connections

Create a new hauler connection.

Roles

Users with the following roles may access this endoint:

Admin
Dispatcher
ThirdPartyAdmin
ThirdPartyDispatcher

Request

POST /haulers/{hauler_uuid}/connections/tenant_code=CROSCRAP%2B1
Authorization: Bearer {your-auth-token}
Content-Type: application/json
x-tenant-id: {your-tenant-id}
{}

Path Parameters

hauler_uuid String, Required

Third party hauler identifier.

  • Valid UUID.

Query Parameters

tenant_code String, Required

Confirmation code for hauler creation.

  • Matches ^\+*+[0-9]{1,10}$
  • At least 1 and no more than 128 characters.

Request Headers

Refer to StandardRequestHeadersModel for more details.

Authorization String, Required

Authorization header (bearer with access token). See the Authentication Guide to get started.

  • Matches ^bearer [a-z0-9-_=]+.[a-z0-9-_=]+.?[a-z0-9-_.+/=]*$
  • No longer than 256 characters.
  • At least 1 characters long.

Content-Type String, Optional

Default Value: application/json

One of the following MIME types:


x-tenant-id Integer, Required

Tenant identifier. Contact CRO Software for more info if you don't already have this id. See list tenant ids for info on listing the tenants you have access to.

Request Body

note

No request body

Response

Response Headers

Refer to StandardResponseHeadersModel for more details.

Accept String

Mime type (e.g. application/json).

  • At least 1 and no more than 256 characters.

Content-Type String, Optional

Default Value: application/json

One of the following MIME types:


x-request-id String

Request identifier.

  • Valid UUID.

Response Body

Refer to ThirdPartyHaulerConnectionModel for more details.

approved_by Integer

Approved by.


approved_on String

Approval date.

  • Date in an ISO 8601 compatible format.

denied_on String

Denial date.

  • Date in an ISO 8601 compatible format.

is_approved Boolean

Approved record state.

  • One of 0, 1, True, False (case insensitive).

location_id Integer

Location identifier.


provider_id Integer

Bin provider identifier.


provider_name String

Name (free text).

  • At least 1 and no more than 64 characters.

requested_on String

Requested date.

  • Date occurring in the past in an ISO 8601 compatible format.

third_party_hauler_id String

Third party hauler identifier.

  • Valid UUID.

Code Samples

curl --request POST --include \
--header "Authorization: Bearer {your-auth-token}" \
--header "Content-Type: application/json" \
--header "x-tenant-id: {your-tenant-id}" \
--data '{}' \
127.0.0.1:8003/haulers/{hauler_uuid}/connections?tenant_code=CROSCRAP%2B1