Push API
This article details how to enter and subscribe devices to an external server endpoint to receive the data.
Read more about push API services
Enter endpoint
- Select API.
- Click the Endpoints tab.
- Click the + Add Endpoint button.
- Enter a URL. The URL must be prepended with "http://", "https://" or "//" to be valid.
- Enter a header key and header value. The header value cannot be empty.
- Click Save.
![](https://files.helpdocs.io/la7ra8dc1e/articles/39tw3ctj9n/1637015409275/add-end-point.gif)
Subscribe devices
- Click the Edit button to the right of the number of Subscribed Devices.
- Select the desired device(s) by turning the toggle on (blue toggle).
- Click Save.
![](https://files.helpdocs.io/la7ra8dc1e/articles/39tw3ctj9n/1637016223410/subscribe-devices-to-endpoint.gif)
Test endpoint
Send a test packet or view an example payload. Must have at least one subscribed device.
![](https://files.helpdocs.io/la7ra8dc1e/articles/39tw3ctj9n/1640804514187/frame-104.png)
Disabled endpoint
If the endpoint has a connection failure (i.e client-server is down, typo in the URL) the endpoint will be disabled after 5 concurrent failures. An email will be sent to notify the user of the connection failure.
![Example: in-app notice of connection failure.](https://files.helpdocs.io/la7ra8dc1e/articles/39tw3ctj9n/1610046574016/api-subscription-12.png)
Example: in-app notice of connection failure.