Skip to main content
Buzzlead Logo Buzzlead is a referral marketing platform that helps businesses grow through ambassador programs, referral tracking, and reward management. This connector extracts data about ambassadors, bonuses, referrals, rescues, and NPS evaluations from your Buzzlead account.

​
Configuration

1

Add account access

To connect Buzzlead, you need:
  • Account Email: The email registered as the account owner in Buzzlead.
  • API Key and API Token: Both available in your Buzzlead dashboard under Integracoes > API.
The API has a rate limit of 600 requests per 5 minutes. The connector handles this automatically with backoff.
2

Select streams

Choose which data streams to sync:
  • Ambassadors: All ambassadors with personal referral links.
  • Bonuses: Bonus records across all campaigns.
  • Referrals: Referral records per campaign (requires Campaign IDs).
  • Rescues: Reward rescue/redemption records.
  • NPS: NPS evaluations per campaign (requires Campaign IDs).
3

Configure data source

Fill in the required configuration:
  • Account Email (required): Your Buzzlead registration email.
  • API Key (required): Your API key from the Buzzlead dashboard.
  • API Token (required): Your API token from the Buzzlead dashboard.
  • Campaign IDs (optional): A list of campaign IDs to fetch referrals and NPS data for. If not provided, the referrals and NPS streams are skipped.
  • Start Date (optional): The earliest date to fetch data from (format: YYYY-MM-DD). Used for filtering bonuses and referrals.
4

Check your new source

After saving the configuration, run a sync to verify that data is flowing correctly. Check that all selected streams produce records.

​
Streams and Fields

List of ambassadors registered in your Buzzlead account with their personal referral links.
FieldTypeDescription
nomestringAmbassador name
emailstringAmbassador email (primary key)
telefonestringPhone number
empresastringCompany name
documentostringDocument number (CPF/CNPJ)
cnpjstringCNPJ number
hashidstringUnique hash identifier
linkstringPersonal referral link
campanhastringCampaign name
campanha_idstringCampaign identifier
createddatetimeCreation date
Bonus records generated from referral conversions across all campaigns.
FieldTypeDescription
origem_nomestringAmbassador name
origem_emailstringAmbassador email
origem_telefonestringAmbassador phone
origem_empresastringAmbassador company
origem_cnpjstringAmbassador CNPJ
datadatetimeBonus creation date
numeroVendastringSale number (primary key)
statusstringBonus status (pendente/confirmado)
valorVendanumberSale value
recompensanumberReward amount
cliente_nomestringConverted customer name
cliente_emailstringConverted customer email
cliente_documentostringCustomer document
campanha_idstringCampaign identifier
campanha_nomestringCampaign name
Referral records per campaign. Requires Campaign IDs to be configured.
FieldTypeDescription
campaign_idstringCampaign identifier (partition key)
codigostringReferral code (primary key)
numerostringNumeric referral code
datadatetimeReferral date
canalstringReferral channel (whatsapp/email/link/facebook)
origem_nomestringReferrer name
origem_emailstringReferrer email
origem_telefonestringReferrer phone
origem_empresastringReferrer company
origem_documentostringReferrer document
destino_nomestringReferred person name
destino_emailstringReferred person email
destino_telefonestringReferred person phone
destino_empresastringReferred person company
destino_documentostringReferred person document
campanha_idstringCampaign identifier
campanha_nomestringCampaign name
situacaostringReferral status (Valida/Invalida)
situacao_motivostringStatus reason
divulgador_nomestringPromoter name
divulgador_emailstringPromoter email
conversaostringConversion details (JSON)
Reward rescue and redemption records.
FieldTypeDescription
hashidstringUnique hash identifier (primary key)
nomestringAmbassador name
emailstringAmbassador email
telefonestringPhone number
statusstringRescue status
valornumberRescue value
campanha_idstringCampaign identifier
campanha_nomestringCampaign name
datadatetimeRescue date
tipostringRescue type
NPS evaluation records per campaign. Requires Campaign IDs to be configured.
FieldTypeDescription
campaign_idstringCampaign identifier (partition key)
nomestringRespondent name
emailstringRespondent email
notaintegerNPS score
comentariostringComment
datadatetimeEvaluation date