How To Use Webhooks

How To Use Webhooks

Webhooks Are Live In Business Level Accounts. 




Webhooks will allow you to send a POST request to a specific URL once a connection event has occurred on any of your connect Pages. You can also append a custom value to the query parameter ?custom_id=  to your connect URL to identify a specific user when a POST request is sent. 


1. How to Setup Your Webhook

When you login to your admatic account you can now go to the connection center and under the white label settings tab you will see the "Agency Webhook" Box now accessible in this section.



  1. Toggle The Enable Webhook to show the webhook box.
  2. Add your webhook URL into this field then hit the save button in the top right. Your webhook will now be called once 

2. Testing Your Webhook


  1. You can then hit the test webhook button to send a sample POST Request to your webhook URL.
    1. It will either return a 200 status or indicate there was an error in sending the POST request. 
  2. This test post request will come across like this:
{
  "data": {
    "analyticsStatus": "Success",
    "connectionEventUUID": "123456-123456-123456-123456",
    "customId": "123456-123456-123456-123456",
    "eventDate": "2024-04-24T02:11:36.658396483Z",
    "eventURL": "test",
    "gbpStatus": "Opted Out",
    "gmcStatus": "Opted Out",
    "googleAdsStatus": "Issue",
    "googleUser": "test@test.com",
    "gscStatus": "Not Requested",
    "gtmStatus": "Not Requested",
    "metaAdAccountStatus": "Success",
    "metaBMName": "test",
    "metaCatalogStatus": "Success",
    "metaInstagramStatus": "Opted Out",
    "metaPagesStatus": "Success",
    "metaPixelStatus": "Opted Out",
    "metaUser": "test@test.com",
    "tiktokUser": "test@test.com",
    "ttAdAccountStatus": "Opted Out",
    "ttBCName": "test",
    "ttPixelStatus": "Issue",
    "ttShopsStatus": "Success",
    "urlNickname": "test",
    "userUUID": "123456-123456-123456-123456"
  }
}

3. Payload Data

ENUMS: Opted Out, Success, Issue, Not Requested

All status fields will have either of the provided values above. Here is a quick definition of these:

Success: We were able to successfully verify or make the connection to your clients account
Opted Out: Client Chose To Opt Out Of Providing Access To This Asset
Not Requested: Your Connect Link Didn't Ask The Client For This Specific Asset
Issue: The asset was requested and there was an issue in the connection of it. 

4. Append Custom Identifier

Additionally you can now set a custom identifier on all your connect pages you send to a client. You can append the query parameter to any of your connect URLs:

?custom_id=your_unique_id_123

You can set this unique identifier to whatever you like. Typically this could be an id form your CRM you want to integrate this with that is specific for that client. 





    • Related Articles

    • Migration Details

      How to Migrate From the Legacy Admatic System Admatic is now back up on a new system with improved performance, better tracking, and a more flexible billing model. Migrating is simple and only takes a few minutes. Follow the steps below to move your ...

    • Integrate With Go High Level

      ** Right Now There Are Intermittent Issues With finding our app in GHL marketplace and if you do sometimes GHL will not register the app so it just spins** We are working with GHL on a solution of why that occurs for some and not others. If you ...

    • Quick Start Guide For Admatic

      Admatic App Guide 1. Dashboard Page: The dashboard page will give you a high level overview of your agency details and current connection integrations you have made mainly (Google, Meta, Tiktok) You may also grab your primary Agency Profile Link from ...

    • iFrame Embedding

      Hey all! We are finally live with the ability to add your connect pages as an iFrame on any website. This is big for those using tools like Go High Level and other funnel type systems where you are making a true automation of your onboarding. **All ...

    • Why your wordpress link isn't working

      Why the WordPress Admin Login Link May Not Be Working If you clicked our link to access your WordPress admin panel to add a user and it didn’t work, don’t worry — this is common and usually easy to fix. Below are the most frequent reasons and what to ...