Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 20 Next »

For sending this request, you have to be authorized. See the Authorization page for more details.

If you want to start using webhooks with your external system and already have some resources in your doo account, you may need to initialize your system with all these existing resources.

After you make the following API request, we will send a webhook request to your external system for each specified resource item that already exists in your doo account. For example, if you chose to initialize all the events from doo, we will send a separate webhook request for each existing event in your doo account.

We send a maximum of 100 initialization webhook requests per minute, so it may take some time if you want to initialize a lot of data.

Request

curl -X POST 'https://rest.doo.net/v1/webhooks/init/<resource_name>' \
-H 'Content-Type: application/json' \
-H 'x-api-key: <api_key>' \
-H 'Authorization: Bearer <access_token>' \
-d '{
  "event_id": <event_id>,
  "organization_id": <organization_id>,
  "last_updated_after": "<last_updated_after>",
  "last_updated_before": "<last_updated_before>",
  "webhook_type": ["<webhook_type>", "<webhook_type>", ...],
  "webhook_configuration_id": "<webhook_configuration_id>",
  "max_rate_per_min": <max_rate_per_min>
}'

Parameters

Parameter

Required

Description

<resource_name>

Yes

The resource you want to initialize.

See Supported resources and webhook types for available resource names.

<api_key>

Yes

See Authorization

<access_token>

Yes

See Authorization

<event_id>

Yes, only for the following resources:

  • orders

  • attendees

  • invitees

<organization_id>

Yes, only for the following resources:

  • events

  • contacts

<last_updated_after>

No

Use it if you want to initialize resources updated after a particular date and time.

Format: Y-m-d H:i:s (example: 2021-03-25 09:00:00)

Timezone: CET

<last_updated_before>

No

Use it if you want to initialize resources updated before a particular date and time.

Format: Y-m-d H:i:s (example: 2021-03-25 16:00:00)

Timezone: CET

<webhook_type>

No

Use it if you want to initialize only particular webhook types.

If not specified, all webhook types for the specified resource will be initialized.

See Supported resources and webhook types for available webhook types for the selected resource.

<webhook_configuration_id>

No

In case you have multiple webhook configurations, you can specify the one for which you want to make the initialization.

If not specified, all the existing webhook configurations will be initialized.

See List webhook configurations to get the Webhook Configuration ID.

max_rate_per_min

No

Specifies the maximum number of requests per minute that we send for the webhook initialization.

You can use this parameter to reduce the load to your system if required.

Default value: 100

Minimum value: 1

Maximum value: 100

Response example

{
    "response_status": 200,
    "developer_message": "Success",
    "user_message": "Success",
    "items_processed": <items_processed_count>,
    "_links": {
        "self": {
            "href": "https://rest.doo.net/v1/webhooks/init/<resource_name>"
        }
    }
}

PC Team easy Guide:

To repush webhooks for 1 event use this:

copy the following code in texteditor and edit <access_token>, <EventID> and <webhook_id>

when finished, open terminal and copy the edited code in terminl, press enter
Below there is the guide on how to get the placeholder for <access_token>, <EventID> and <webhook_id>

curl -X POST 'https://rest.doo.net/v1/webhooks/init/orders' \
-H 'Content-Type: application/json' \
-H 'x-api-key: doo-test-key-3306c337-4e00-43de-a63d-44c4fb122ea8' \
-H 'Authorization: Bearer <access_token>' \
-d '{
  "event_id": <EventID>,
   "webhook_configuration_id":"<webhook_id>"
}'

real Example:

curl -X POST 'https://rest.doo.net/v1/webhooks/init/orders' \
-H 'Content-Type: application/json' \
-H 'x-api-key: doo-test-key-3306c337-4e00-43de-a63d-44c4fb122ea8' \
-H 'Authorization: Bearer acd9d531db1e30a8ba66555ed7830e066af1dde3' \
-d '{
  "event_id": 41231,
   "webhook_configuration_id":"eaf6e0e9-e116-0bbd-e121-b30716188331"
}'

How to get <access_token>:

  • go in doo manager app to your desired OID

  • open developer tool (Chrome & Firefox: F12 or fn+F12)

  • go to Network tab

  • select: Fetch/XHR

  • record network log and maybe clear once

  • click on a event or booking, does not matter, just do something in doo manager

  • in the network logs is_active should appear

  • click on is_active and check the Headers for “Request Headers”

  • scroll down and search for authorization: Bearer ...

  • the shown token is your <access_token>

How to get <EventID>:

  • this is just the EventID

How to get <webhook_id>:

  • go in doo manager app to your desired OID

  • go to DAT (https://dat.doo.net/auth/login )

  • login and double check if you are in the correct OID in DAT

  • go to Webhooks

  • you will see the <webhook_id>, if there are multiple webhook ids, choose the “correct” one that should be repushed



  • No labels