Vraag vroegtijdige toegang aan

Vul je voornaam en een e-mailadres of telefoonnummer in. We nemen daarna contact met je op en leggen uit hoe je toegang krijgt tot Tajo.

Op deze pagina

Create Contact

Add new customers to your Brevo contact database with loyalty program information and custom attributes for personalized engagement.

Quick Start

Basic Contact Creation

POST https://api.brevo.com/v3/contacts
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "email": "[email protected]",
  "attributes": {
    "FIRSTNAME": "John",
    "LASTNAME": "Doe",
    "LOYALTY_POINTS": 1500,
    "LOYALTY_TIER": "Gold",
    "SIGNUP_DATE": "2024-01-15",
    "LAST_PURCHASE": "2024-01-20",
    "TOTAL_SPENT": 299.99
  },
  "listIds": [1, 2],
  "updateEnabled": true
}

Antwoord

{
  "id": 123456
}

Loyalty Program Integration

New Customer with Loyalty Attributes

{
  "email": "[email protected]",
  "attributes": {
    "FIRSTNAME": "Sarah",
    "LASTNAME": "Johnson",
    "PHONE": "+1234567890",
    "LOYALTY_ID": "LYL-2024-001",
    "LOYALTY_POINTS": 0,
    "LOYALTY_TIER": "Bronze",
    "PREFERRED_REWARDS": "Discounts",
    "BIRTHDAY": "1990-05-15",
    "SIGNUP_SOURCE": "Website",
    "REFERRAL_CODE": "REF-12345",
    "COMMUNICATION_PREFERENCES": "Email,SMS",
    "PURCHASE_CATEGORIES": ["Electronics", "Fashion"],
    "AVERAGE_ORDER_VALUE": 0
  },
  "listIds": [1], // New customers list
  "emailBlacklisted": false,
  "smsBlacklisted": false,
  "updateEnabled": true
}

Existing Customer Update

{
  "email": "[email protected]",
  "attributes": {
    "LOYALTY_POINTS": 2500,
    "LOYALTY_TIER": "Platinum",
    "LAST_PURCHASE": "2024-01-25",
    "TOTAL_SPENT": 1299.99,
    "RECENT_PURCHASES": ["Product A", "Product B"],
    "ENGAGEMENT_SCORE": 8.5,
    "LAST_EMAIL_OPENED": "2024-01-24",
    "PREFERRED_CONTACT_TIME": "Evening"
  },
  "listIds": [1, 3], // Add to platinum customers list
  "updateEnabled": true
}

Tajo-Specific Attributes

Customer Loyalty Data

Attribute Name	Type	Description
`LOYALTY_ID`	String	Unique loyalty program ID
`LOYALTY_POINTS`	Number	Current points balance
`LOYALTY_TIER`	String	Current tier (Bronze, Silver, Gold, Platinum)
`POINTS_EARNED_YTD`	Number	Points earned this year
`POINTS_REDEEMED_YTD`	Number	Points redeemed this year
`TIER_PROGRESS`	Number	Progress to next tier (%)
`NEXT_TIER_POINTS`	Number	Points needed for next tier

Purchase Behavior

Attribute Name	Type	Description
`TOTAL_SPENT`	Number	Lifetime value
`AVERAGE_ORDER_VALUE`	Number	Average purchase amount
`PURCHASE_FREQUENCY`	String	How often they buy
`LAST_PURCHASE`	Date	Last purchase date
`FAVORITE_CATEGORIES`	Array	Preferred product categories
`SEASONAL_BUYER`	Boolean	Shops seasonally

Engagement Metrics

Attribute Name	Type	Description
`ENGAGEMENT_SCORE`	Number	1-10 engagement rating
`EMAIL_OPEN_RATE`	Number	Personal open rate %
`CLICK_THROUGH_RATE`	Number	Personal CTR %
`LAST_EMAIL_OPENED`	Date	Last email interaction
`PREFERRED_CHANNEL`	String	Email, SMS, WhatsApp

Batch Contact Creation

Create multiple contacts at once:

{
  "contacts": [
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Alice",
        "LOYALTY_POINTS": 500,
        "LOYALTY_TIER": "Bronze"
      }
    },
    {
      "email": "[email protected]",
      "attributes": {
        "FIRSTNAME": "Bob",
        "LOYALTY_POINTS": 1200,
        "LOYALTY_TIER": "Silver"
      }
    }
  ],
  "listIds": [1],
  "updateEnabled": true
}

Foutafhandeling

Common errors and solutions:

{
  "code": "duplicate_parameter",
  "message": "Contact already exists",
  "details": {
    "email": "[email protected]",
    "existingId": 123456
  }
}

{
  "code": "invalid_parameter",
  "message": "Invalid list ID",
  "details": {
    "listIds": [999]
  }
}

Beste Praktijken for Tajo

Always Include Core Loyalty Fields: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
Set Update Enabled: Allow updates to existing contacts
Use Segmentation Lists: Organize by tier, behavior, preferences
Track Engagement: Monitor email/SMS interaction rates
Regular Data Sync: Keep loyalty data current with your system

Next Steps

Update Contact Attributes
Manage Contact Lists
Set up Custom Attributes
Import Bulk Contacts