Custom Datasource

By using Metricly‘s Ingest endpoint, you can view your custom data in Metricly. Consult the custom ingest info in the Appendix if you need help.




If you need to disable an existing Custom integration or view the unique API key assigned to your account, navigate to the Integrations page under the user account drop-down menu and click the integration designated as Custom under the Integration column.


  • Setting up a new custom integration is a 2-step process:
    1. Copy the unique API key from the Custom integration in your account.
    2. POST to Metricly’s API using the API ID generated in Step 1.

    Step 1: Copy the API key from the Custom integration in your account

    1. From the top navigation menu, select Integrations.
    2. Select the Custom Datasource card. The name should be already populated, and Data Collection should be enabled. A unique API key for your account has already been generated.
    3. Copy the API key.

    Step 2: POST to Metricly’s API

    1. Have your preferred REST client open and ready. Change your method call to POST and the URL to{apiId}.
      To explore Metricly’s REST API and test some requests, go here.
    2. Replace {apiId} in the URL with the unique API key generated for your account that you copied in step 1.
    3. Use the Ingest API help to create a JSON package for your POST request.
    4. After completing the required parameters in your JSON Request Body, POST to the API from your REST client. You should schedule a data push at least once in every five-minute cycle. If you cannot send data every five minutes, you should consider a missing data strategy (e.g., sending zeroes).
      If the timestamp on your POST is not passed correctly or the POST is not in the given 5 minute window, your data will not show in Metricly. The timestamp on your POST must be in the correct format (e.g., 2015-08-04T19:00:17UTC) for Metricly’s API to accept the POST.