get https://api.getblueshift.com/api/v1/data_connectors/:data_connector_uuid/debug
Use this endpoint to download the first 10 success and errored events in last 5 minutes.
Considerations
- Event data for both success and error events are sent in batches at every five-minute interval. Each batch will have a maximum of 5 events as shown in the example below.
- The API saves only the first five events (in the order they happened) and not all historical events in a batch. If there are no events in that timeframe, then both the success and error arrays would be empty.
API at a glance
Event export errors (if any) are exported to the following S3 location:
- Bucket:
bsft-customers - S3_path:
<site>/events_export/amplitude_de/errors/<year>/<month>/<day>
In the Blueshift UI, you can view and download logs from the Event exports index page.
Sample payload batch of 5 success events
{
"success": [
{
"api_key": "****",
"events": [
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:11.171Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"customer_id": "[email protected]",
"event-id": "156",
"score": null,
"session_uuid": "b09812d0-c695-4a7a-a96f-eabae81fa185",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:11.171Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "b3b29bc2-59eb-43bc-bb88-162076d563f2"
},
"event_type": "[Blueshift] identify1",
"insert_id": "3e439ce5-bbe1-4978-b7cf-4c090f21894d",
"partner_id": "blueshift",
"time": 1715260511,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:13.744Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"customer_id": "[email protected]",
"event-id": "157",
"score": null,
"session_uuid": "b09812d0-c695-4a7a-a96f-eabae81fa185",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:13.744Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "b3b29bc2-59eb-43bc-bb88-162076d563f2"
},
"event_type": "[Blueshift] identify1",
"insert_id": "e3c53400-e6a8-4b82-acac-703d0d5f7cc8",
"partner_id": "blueshift",
"time": 1715260513,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:16.380Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"customer_id": "[email protected]",
"event-id": "158",
"score": null,
"session_uuid": "b09812d0-c695-4a7a-a96f-eabae81fa185",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:16.380Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "b3b29bc2-59eb-43bc-bb88-162076d563f2"
},
"event_type": "[Blueshift] identify1",
"insert_id": "59cbb07a-e20d-44f4-97d0-33af6122176b",
"partner_id": "blueshift",
"time": 1715260516,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:19.374Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"customer_id": "[email protected]",
"event-id": "159",
"score": null,
"session_uuid": "b09812d0-c695-4a7a-a96f-eabae81fa185",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:19.374Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "b3b29bc2-59eb-43bc-bb88-162076d563f2"
},
"event_type": "[Blueshift] identify1",
"insert_id": "9f8afbf6-a948-410a-81cb-e4eb66f3229a",
"partner_id": "blueshift",
"time": 1715260519,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:24.636Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"customer_id": "[email protected]",
"event-id": "160",
"score": null,
"session_uuid": "b09812d0-c695-4a7a-a96f-eabae81fa185",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:24.636Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "b3b29bc2-59eb-43bc-bb88-162076d563f2"
},
"event_type": "[Blueshift] identify1",
"insert_id": "5c31c5f8-9505-4e20-8f63-b1016111eac0",
"partner_id": "blueshift",
"time": 1715260524,
"user_id": "[email protected]"
}]
},
{
"api_key": "****",
"events": [
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:30.308Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"event-id": "161",
"score": null,
"session_uuid": "90e1a450-fdcf-4901-a5ff-4c7c6161b1c9",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:30.309Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "143e14ca-df41-4502-a8d7-9721bfc250c6"
},
"event_type": "[Blueshift] identify1",
"insert_id": "af60e71a-ddcc-44b0-be53-ffa4186f44bb",
"partner_id": "blueshift",
"time": 1715260530,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:32.883Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"event-id": "162",
"score": null,
"session_uuid": "90e1a450-fdcf-4901-a5ff-4c7c6161b1c9",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:32.883Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "143e14ca-df41-4502-a8d7-9721bfc250c6"
},
"event_type": "[Blueshift] identify1",
"insert_id": "bc4a7620-89f9-4bac-8add-c9829f439fb1",
"partner_id": "blueshift",
"time": 1715260532,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:35.253Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"event-id": "163",
"score": null,
"session_uuid": "90e1a450-fdcf-4901-a5ff-4c7c6161b1c9",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:35.253Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "143e14ca-df41-4502-a8d7-9721bfc250c6"
},
"event_type": "[Blueshift] identify1",
"insert_id": "5d9f2e4f-9d6b-443e-90ce-d9e6c21b7e20",
"partner_id": "blueshift",
"time": 1715260535,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:37.856Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"event-id": "164",
"score": null,
"session_uuid": "90e1a450-fdcf-4901-a5ff-4c7c6161b1c9",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:37.856Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "143e14ca-df41-4502-a8d7-9721bfc250c6"
},
"event_type": "[Blueshift] identify1",
"insert_id": "a564c701-4489-454b-9be3-89022ed134aa",
"partner_id": "blueshift",
"time": 1715260537,
"user_id": "[email protected]"
},
{
"event_properties":
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T13:15:40.058Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.3",
"custom_event": "identify1",
"event-id": "165",
"score": null,
"session_uuid": "90e1a450-fdcf-4901-a5ff-4c7c6161b1c9",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T13:15:40.058Z",
"user_agent": "PostmanRuntime/7.37.3",
"user_uuid": "143e14ca-df41-4502-a8d7-9721bfc250c6"
},
"event_type": "[Blueshift] identify1",
"insert_id": "1b677162-0dfe-4d59-a0ff-cefaa91f561c",
"partner_id": "blueshift",
"time": 1715260540,
"user_id": "[email protected]"
}]
}]
}
Sample payload batch of 5 failure events
{
"failures": [
{
"_bsft_outbound_data_error": "User identifier not found at index - 1",
"events": [
{
"_bsft_js_events_export": true,
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"customer_id": "rt1",
"email": "[email protected]",
"event": "add_to_cart",
"event_uuid": "c71e1188-0df0-11ef-8b5d-0242ac110003",
"product_ids": ["624860"],
"product_save_mode": "add_to_timeline",
"score": null,
"site": "bsftfeb23test1.com",
"test_count": "file_upload_05",
"timestamp": "2024-05-09T10:42:05+00:00",
"user_uuid": "bbbe38a9-41ef-4662-b217-7fb70e1f777e"
},
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T11:06:10.880Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.0",
"companyname": "google",
"custom_event": "cancel",
"customer_id": "rounak_c15",
"event": "cancel",
"event_uuid": "839664ce-2c1c-4a8b-a896-5f4809f312d4",
"score": 70,
"session_uuid": "bf3a5e57-751f-4772-8f6f-015670b3d558",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T11:06:10.887Z",
"timestamp_epoch": 1715252770,
"user_agent": "PostmanRuntime/7.37.0",
"user_uuid": "6d6434b1-d3e8-4fcc-8f17-df542d05f9a7"
},
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T11:06:10.880Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.0",
"companyname": "microsoft",
"email": "[email protected]",
"event": "purchase",
"event_uuid": "86cec0d4-4ccf-45e3-80ab-5dda98d31dbc",
"product_ids": ["cbou_beans_1"],
"product_save_mode": "add_to_timeline",
"score": 90,
"session_uuid": "581abf3c-0ea5-47d7-afdd-31dbff1f8d82",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T11:06:10.927Z",
"timestamp_epoch": 1715252770,
"user_agent": "PostmanRuntime/7.37.0",
"user_uuid": "f6c27d7b-208c-4052-af8f-76c347cd145b"
},
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T11:06:10.880Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"action": "custom_event",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.0",
"companyname": "google",
"custom_event": "cancel",
"customer_id": "rounak_c15",
"event": "cancel",
"event_uuid": "839664ce-2c1c-4a8b-a896-5f4809f312d4",
"score": 70,
"session_uuid": "bf3a5e57-751f-4772-8f6f-015670b3d558",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T11:06:10.887Z",
"timestamp_epoch": 1715252770,
"user_agent": "PostmanRuntime/7.37.0",
"user_uuid": "6d6434b1-d3e8-4fcc-8f17-df542d05f9a7"
},
{
"_bsft_js_events_export": true,
"_bsft_js_pipeline": true,
"_bsft_ts": "2024-05-09T11:06:10.880Z",
"account_uuid": "5f2e44c3-97e4-4ecf-af72-c84e1a238e21",
"browser_type": "PostmanRuntime",
"browser_version": "7.37.0",
"companyname": "microsoft",
"email": "[email protected]",
"event": "purchase",
"event_uuid": "86cec0d4-4ccf-45e3-80ab-5dda98d31dbc",
"product_ids": ["cbou_beans_1"],
"product_save_mode": "add_to_timeline",
"score": 90,
"session_uuid": "581abf3c-0ea5-47d7-afdd-31dbff1f8d82",
"site": "bsftfeb23test1.com",
"timestamp": "2024-05-09T11:06:10.927Z",
"timestamp_epoch": 1715252770,
"user_agent": "PostmanRuntime/7.37.0",
"user_uuid": "f6c27d7b-208c-4052-af8f-76c347cd145b"
}]
}]
}
Try it out
- Add the User API key as the Username and leave the Password field blank.
- Click the Base URL dropdown and select the API endpoint URL for your Blueshift region.
- Click Try It.
You can also try the API using Blueshift's API collection in Postman.