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

    • 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 ...

    • 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 ...

    • Auto Assign Meta Business Manager Users

      Hey Guys! We are now live with being able to auto assign your team to newly added assets from any of your connect pages. **Note this is only for business plan users and above** What is this? First lets dive into how Meta business manager works... ...

    • Quick Start Guide For Admatic

      Admatic App Guide 1. Dashboard Page: Upon logging in, you'll be directed to the Dashboard Page. Here, you'll find your primary link for connecting with agency accounts. Steps: Generate your account. Click "Copy" to obtain your unique link. 2. ...

    • Create Meta Assets (Business Manager, Ad Accounts, Pages)

      Hey Guys! As of today we have launched the ability for your users on your connect page to have the ability to create a business manager when they do not have one. This feature is available on all plans Here is a quick recap video of how this works: ...