Skip to content

[Facebook Conversions API] Add ctwa_clid in user data of fb conversions apis#3601

Draft
harsh-joshi99 wants to merge 1 commit intomainfrom
STRATCONN-6454
Draft

[Facebook Conversions API] Add ctwa_clid in user data of fb conversions apis#3601
harsh-joshi99 wants to merge 1 commit intomainfrom
STRATCONN-6454

Conversation

@harsh-joshi99
Copy link
Contributor

@harsh-joshi99 harsh-joshi99 commented Feb 13, 2026

Adds support for Meta’s Click to WhatsApp Click ID (ctwa_clid) to the Facebook Conversions API destination by exposing it as a user_data field, normalizing it, and ensuring it is included in outgoing payloads.

Changes:

Add ctwa_clid to the user_data input field definition and include it in the serialized CAPI user_data payload.
Normalize ctwa_clid by trimming whitespace.
Add unit tests across actions to assert ctwa_clid is passed through in user_data.

JIRA: https://twilio-engineering.atlassian.net/browse/STRATCONN-6454

Testing

Stage Testing Document

Include any additional information about the testing you have completed to
ensure your changes behave as expected. For a speedy review, please check
any of the tasks you completed below during your testing.

  • Added unit tests for new functionality
  • Tested end-to-end using the local server
  • [If destination is already live] Tested for backward compatibility of destination. Note: New required fields are a breaking change.
  • [Segmenters] Tested in the staging environment
  • [Segmenters] [If applicable for this change] Tested for regression with Hadron.

Security Review

Please ensure sensitive data is properly protected in your integration.

  • Reviewed all field definitions for sensitive data (API keys, tokens, passwords, client secrets) and confirmed they use type: 'password'

New Destination Checklist

  • Extracted all action API versions to verioning-info.ts file. example

@codecov
Copy link

codecov bot commented Feb 13, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 80.31%. Comparing base (ac4ec3b) to head (2a29404).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #3601   +/-   ##
=======================================
  Coverage   80.31%   80.31%           
=======================================
  Files        1283     1283           
  Lines       23567    23569    +2     
  Branches     4726     4728    +2     
=======================================
+ Hits        18928    18930    +2     
  Misses       3757     3757           
  Partials      882      882           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds support for Meta’s Click to WhatsApp Click ID (ctwa_clid) to the Facebook Conversions API destination by exposing it as a user_data field, normalizing it, and ensuring it is included in outgoing payloads.

Changes:

  • Add ctwa_clid to the user_data input field definition and include it in the serialized CAPI user_data payload.
  • Normalize ctwa_clid by trimming whitespace.
  • Add unit tests across actions to assert ctwa_clid is passed through in user_data.

Reviewed changes

Copilot reviewed 30 out of 30 changed files in this pull request and generated no comments.

Show a summary per file
File Description
packages/destination-actions/src/destinations/facebook-conversions-api/fb-capi-user-data.ts Adds ctwa_clid field definition, trims it during normalization, and includes it in the outgoing user_data object.
packages/destination-actions/src/destinations/facebook-conversions-api/addToCart/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/addToCart2/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/custom/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/custom2/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/initiateCheckout/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/initiateCheckout2/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/pageView/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/pageView2/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/purchase/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/purchase2/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/search/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/search2/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/viewContent/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/viewContent2/generated-types.ts Regenerates action payload types to include ctwa_clid in user_data.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/user-data.test.ts Adds coverage verifying ctwa_clid is trimmed during normalization.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/addToCart.test.ts Adds coverage verifying ctwa_clid is included in user_data for addToCart.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/addToCart2.test.ts Adds coverage verifying ctwa_clid is included in user_data for addToCart2.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/custom.test.ts Adds coverage verifying ctwa_clid is included in user_data for custom.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/custom2.test.ts Adds coverage verifying ctwa_clid is included in user_data for custom2.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/initiateCheckout.test.ts Adds coverage verifying ctwa_clid is included in user_data for initiateCheckout.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/initiateCheckout2.test.ts Adds coverage verifying ctwa_clid is included in user_data for initiateCheckout2.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/pageView.test.ts Adds coverage verifying ctwa_clid is included in user_data for pageView.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/pageView2.test.ts Adds coverage verifying ctwa_clid is included in user_data for pageView2.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/purchase.test.ts Adds coverage verifying ctwa_clid is included in user_data for purchase.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/purchase2.test.ts Adds coverage verifying ctwa_clid is included in user_data for purchase2.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/search.test.ts Adds coverage verifying ctwa_clid is included in user_data for search.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/search2.test.ts Adds coverage verifying ctwa_clid is included in user_data for search2.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/viewContent.test.ts Adds coverage verifying ctwa_clid is included in user_data for viewContent.
packages/destination-actions/src/destinations/facebook-conversions-api/tests/viewContent2.test.ts Adds coverage verifying ctwa_clid is included in user_data for viewContent2.

@harsh-joshi99 harsh-joshi99 marked this pull request as ready for review February 17, 2026 08:42
@harsh-joshi99 harsh-joshi99 requested a review from a team as a code owner February 17, 2026 08:42
@harsh-joshi99 harsh-joshi99 changed the title Add ctwa_clid in user data of fb conversions apis [Facebook Conversions API] Add ctwa_clid in user data of fb conversions apis Feb 17, 2026
@harsh-joshi99 harsh-joshi99 marked this pull request as draft February 17, 2026 09:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants