Skip to content

Bitrix24 Integration

Learn how to set up OneClick Tracking in Bitrix24 CRM.

OneClick Tracking records as conversions the Bitrix24 deals that reach the pipeline stages you choose, and links each one to the Meta ad that brought the customer. Your campaigns’ CPA and ROAS then reflect your sales team’s real results.

The integration works with Bitrix24 cloud (yourcompany.bitrix24.com, .com.br and the other Bitrix24 domains). Portals on a custom domain and self-hosted (on-premise) Bitrix24 are not supported.


Bitrix24 deals have their own UTM fields (UTM_SOURCE, UTM_MEDIUM, UTM_CAMPAIGN, UTM_CONTENT and UTM_TERM). Bitrix24 CRM forms and website widgets fill them with the visit’s UTMs. OneClick also reads deal custom fields with those names (for example, UF_CRM_UTM_SOURCE).

A deal created by hand or from a WhatsApp chat arrives without UTMs: it stays in your Bitrix24 as usual, but it does not become a tracked conversion, because there is no ad to attribute it to.


How to Connect OneClick Tracking to Bitrix24

Section titled “How to Connect OneClick Tracking to Bitrix24”
  1. Log in to your OneClick Ads account.

  2. Go to the "OneClick Tracking" tab, available in the left sidebar of OneClick Ads.

    The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card

  3. Click "New Integration".

  4. Select the "Lead Generation" product type and click Continue.

  5. Select the "Bitrix24" platform and click Continue.

  1. Paste the Bitrix24 inbound webhook URL and click Connect. a. In Bitrix24, open Applications > Developer resources > Other > Inbound webhook. b. Under Permissions, tick CRM (crm) and save. c. Copy the URL Bitrix24 shows, shaped like https://yourcompany.bitrix24.com/rest/1/abc123.../. The URL works like a password: do not share it. d. Create the webhook with a user who can see every deal in the pipeline: OneClick reads deals with that user’s permissions.

  2. Choose which stages count as a conversion. a. OneClick lists your Bitrix24 deal pipelines and their stages. b. Tick the stages that are a real conversion for your business (for example, “Proposal sent” or “Deal won”).

  1. Copy the UTM Script generated in OneClick Tracking.

    The UTM parameters step of OneClick Tracking, with the parameter to copy

    8.1. Paste it into the "URL parameters" field in ALL of your ads in Ads Manager, as shown below:

    The URL parameters field of an ad in Meta Ads Manager

  1. Add the UTM Passthrough Script to all your sales pages, so the UTMs are automatically carried into the card of each lead generated. a. You can install it on your website via Google Tag Manager or, preferably, directly in your website's header.
  1. Set the Attribution Mode.

The Attribution Mode step of OneClick Tracking

  1. Set the Naming Convention that your campaigns, ad sets and ads will receive in your Ads Manager and click next.

The Campaign Naming step of OneClick Tracking Analysis periods and the Naming Convention preview

  1. Copy the Webhook URL OneClick generates and create, in Bitrix24, the webhook that tells OneClick when a deal changes:

    11.1. In Bitrix24, open Applications > Developer resources > Other > Outbound webhook.

    11.2. In Handler URL, paste the OneClick Webhook URL.

    11.3. Under Events, tick Deal updated (ONCRMDEALUPDATE) and Deal created (ONCRMDEALADD), and save.


  • Each stage you chose counts once per deal: editing the same deal again in the same stage does not create a duplicate conversion. If you choose several stages, a deal that goes through all of them counts once in each.
  • In Bitrix24, “won” and “lost” are stages too: the stage you tick in step 7 is what counts as a conversion.
  • The recorded value is the deal amount (Opportunity field), in the deal’s currency.
  • The conversion date is when the deal entered the stage.
  • If you delete or recreate the inbound webhook in Bitrix24, reconnect the integration in OneClick with the new URL.

Wait at least 24 hours for the setup to take effect, and all your campaigns (those that receive conversions) will start recording conversions right inside Ads Manager.

Campaigns with the OneClick Tracking prefix in Ads Manager