airbyte/docs/integrations/sources/onesignal.md

OneSignal

This page contains the setup guide and reference information for the OneSignal source connector.

Prerequisites

• User Auth Key
• Applications credentials (App Id & REST API Key)

Setup guide

Step 1: Set up OneSignal

Step 2: Set up the OneSignal connector in Airbyte

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. Click Sources and then click + New source.
3. On the Set up the source page, select OneSignal from the Source type dropdown.
4. Enter a name for the OneSignal connector.
5. Enter User Auth Key
6. Enter Applications credentials (repeat for every application):
   1. Enter App Name (for internal purposes only)
   2. Enter App ID
   3. Enter REST API Key
7. Enter the Start Date in format YYYY-MM-DDTHH:mm:ssZ
8. Enter Outcome names as comma separated values, e.g. os__session_duration.count,os__click.count, see the API docs for more details.

For Airbyte Open Source:

1. Navigate to the Airbyte Open Source dashboard.
2. Click Sources and then click + New source.
3. On the Set up the source page, select OneSignal from the Source type dropdown.
4. Enter the name for the OneSignal connector.
5. Enter User Auth Key
6. Enter Applications credentials (repeat for every application):
   1. Enter App Name (for internal purposes only)
   2. Enter App ID
   3. Enter REST API Key
7. Enter the Start Date in format YYYY-MM-DDTHH:mm:ssZ
8. Enter Outcome names as comma separated values, e.g. os__session_duration.count,os__click.count, see the API docs for more details.

Supported sync modes

The OneSignal source connector supports the following sync modes:

• Full Refresh - Overwrite
• Full Refresh - Append
• Incremental - Append
• Incremental - Append + Deduped

Supported Streams

• Apps
• Devices (Incremental)
• Notifications (Incremental)
• Outcomes

Performance considerations

The connector is restricted by normal OneSignal rate limits.

Data type mapping

Integration Type	Airbyte Type	Notes
string	string
integer	integer
number	number
array	array
object	object

Changelog

Expand to review

Version	Date	Pull Request	Subject
1.2.0	2024-10-05	46372	Converting to manifest-only format
1.1.14	2024-09-28	46184	Update dependencies
1.1.13	2024-09-21	45788	Update dependencies
1.1.12	2024-09-14	45528	Update dependencies
1.1.11	2024-09-07	45228	Update dependencies
1.1.10	2024-08-31	45046	Update dependencies
1.1.9	2024-08-24	44673	Update dependencies
1.1.8	2024-08-17	44333	Update dependencies
1.1.7	2024-08-12	43767	Update dependencies
1.1.6	2024-08-10	43468	Update dependencies
1.1.5	2024-08-03	42742	Update dependencies
1.1.4	2024-07-20	42293	Update dependencies
1.1.3	2024-07-13	41785	Update dependencies
1.1.2	2024-07-10	41317	Update dependencies
1.1.1	2024-07-09	41033	Migrate to poetry base
1.1.0	2023-08-31	28941	Migrate connector to low-code
1.0.1	2023-03-14	24076	Fix schema and add additionalProperties true
1.0.0	2023-03-14	24076	Update connectors spec; fix incremental sync
0.1.2	2021-12-07	8582	Update connector fields title/description
0.1.1	2021-11-10	7617	Fix get_update state
0.1.0	2021-10-13	6998	Initial Release