Bringg Services

Bringg Services are unique URLs that merchants can create and use without using an authentication token. Each Bringg Service URL is composed of three GUIDs that Bringg generates when a user creates a Bringg Service. The GUIDs ensure secure requests without authentication.

📘

General Form of a Bringg Service

The general form of a Bringg Service is the following:

https://admin-api.bringg.com/services/{serviceId}/{service_uuid1}/{service_uuid2}/

where {serviceId}, {service_uuid1}, and {service_uuid2} are GUIDs (universally unique) created by Bringg for each service.

Merchants create Bringg Services using the name of the endpoint action for which a service is required. Bringg then generates the unique Bringg Service URL. For example, a merchant can create unique Bringg Service URLs for Create Order, Update Order, and Cancel Order. That merchant's Bringg Service URLs for Create Order, Update Order, and Cancel Order are different than all other Bringg Services for any merchant.

📘

All Bringg Services are POST Methods

Bringg Services POST methods are different than other API POST methods.

Bringg Services may require:

  • input parameters in the body, only

Bringg Services return a response:

  • output parameters

Bringg Services do not require:

  • path parameters in the URL
  • collection names in the URL
  • Ids in the URL

Using Bringg Tags with Bringg Services

Use Bringg Tags with Bringg Services URLs by either of the following methods:

  • the _same _Bringg Tag for _every _execution of the URL - assign a Bringg Tag when you create a Bringg Service URL.
  • a different _Bringg Tag for _each _execution of the URL - use the _tag_id parameter in the body when you use a Bringg Service URL.

NOTE: You can create more than one Bringg Services URL for the same action and use different Bringg Tags for each.

Creating Bringg Services

Create Bringg Services using the endpoint action names for which you require a service. For example, use the endpoint action names Create Order to create a Bringg Service for Create Order. No additional configuration in Bringg is required.

To Create a Bringg Service:

  1. In your company profile, go to Webhooks & API.
  • Click the API tab. The API panel appears.
  • At the bottom of API panel, in the API Type, Action list, click your required endpoint action names.
  • If required, in the Optional Tag text box, type the name of a Bringg Tag to use with all executions of this Bringg Service (see, Bringg Tags).
  • Click Add Service. The new Bringg Service is created. The Bringg Service URL appears in the alphabetized list of Bringg Services.

📘

Multiple Bringg Services for the Same Endpoint Action

You can create more than one Bringg Service URL for the same endpoint action. Each Bringg Service URL can use a different Bringg Tag.

Finding Bringg Service URLs

If the required Bringg Service URL was previously created, you can find the URL in the list of Bringg Service URLs.

To find a Bringg Service URL:

  1. In your company profile, go to Webhooks & API.
  • Click the API tab. The API panel appears.
  • Locate your required Bringg Service URL in the alphabetized list of services.

Deleting Bringg Services URLs

Delete a Bringg Service URL.

To delete a Bringg Service URL:

  1. In your company profile, go to Webhooks & API.
  • Click the API tab. The API panel appears.
  • In the required Bringg Service URL row, click the red delete button. The Bringg Service URL is deleted.

List of Bringg Services

The following is a list of the Bringg Services.

Bringg Service NameDescription
Arrived To Location (Check-In)Update an order (task) that the driver arrived at the next location (check in).
Cancel OrderCancel an order (task).
Create CustomerCreate a new customer.
Create NoteCreate a note for a way point.
Create OrderCreate a new order (task).
Create Task ConfigurationCreate a task configuration.
Create TeamCreate a new team.
Create UserCreate a new user (driver, dispatcher, or admin)
Delete TeamDelete a team.
Delete UserDelete a user (driver, dispatcher, or admin).
Driver Home EventsReturns a message indicating whether a driver got home or left home.
eCourier Integration(The reference page documentation for this service is currently being updated).
End OrderEnd order (task).
End ShiftEnd the shift of a user (driver).
Get QuoteGet the availability and fee (cost) of deliveries given a specific requirement
Get Real-time Driver AvailabilityGet the real-time driver availability details of drivers in the teams you specify.
Get Share(The reference page documentation for this service is currently being updated).
Get Team DetailsGet the details of a team.
Get UserGet the details of a user (driver, dispatcher, or admin).
Import Orders CSV(The reference page documentation for this service is currently being updated).
Import Orders CSV (async)(The reference page documentation for this service is currently being updated).
Import Orders CSV Progress(The reference page documentation for this service is currently being updated).
Import Users CSV API(The reference page documentation for this service is currently being updated).
Import Users CSV Files(The reference page documentation for this service is currently being updated).
JustEat Integration(The reference page documentation for this service is currently being updated).
Left Location(The reference page documentation for this service is currently being updated).
Open OrdersList all open orders.
Post Optimization OrdersList all post optimization orders.
Start ShiftStart the shift of a user.
Start OrderStart an order.
Update CustomerUpdate a customer's details.
Update OrderUpdate an order's (task's) details.
Update TeamUpdate a team's details.
Update UserUpdate a user's details.