Flow Documentation
Back to Flow Platform
  • Back to Flow Platform
  • Getting Started
  • Publisher Documentation
    • Introduction
    • Integrating with Flow
      • The Integration Journey
      • How to choose your integration method
        • Set-up requirements for the different integration methods
      • Integrating via Console, Link-Out and Smartfeed
        • Console
          • Console Set-Up Steps
          • Flow Console Authentication
            • Authentication method: SAML Single Sign-On
              • Final URL
        • Link-Out (self-serve)
          • Link-Out Road Map
          • Choosing between Link-Out Advanced or Basic
          • Link-Out Set-Up Steps
          • Link-Out Authentication
          • Link-Out Advanced: For clients with a feed configured
          • Link-Out Basic: Alternative to a Content Feed
        • Smartfeed
          • Smartfeed Set-up Steps
          • How the Smartfeed Engine Works
          • Campaign Triggers
      • Content Feeds
        • Content Feed Overview: What is it, why we use it, do you need it
        • Setting up a Content Feed
        • Listing API
      • Campaign Packages
        • Campaign Packages Overview: What is it, why we use it, do you need it
        • Structuring a Package
        • Understanding Campaign Objectives
      • Webhooks
        • Campaigns Webhooks
        • Leads Webhooks
      • Analytics API
        • Campaigns
        • Insights
    • Account Configuration
      • Navigating the Flow Console
      • Channel Configuration
      • Audience Tracking
      • Custom Ad Templates
      • Whitelabelling
    • Managing the Flow Console
      • Navigating the Flow Console
      • Campaigns
        • Publishing Campaigns
        • Monitoring Campaigns
        • Managing Subscriptions
      • Analytics
        • Flow Insights Dashboard: Enterprise Organisation
        • Flow Enterprise Dashboard: Filtering your Data
        • Flow Enterprise Dashboard: Insights Available
      • Content
        • Editing Content Manually
        • Add Content Manually
        • Previewing Content
        • Viewing Your Brands
      • Enquiries
      • Packages
        • How to create Campaign Packages
        • How to edit a Campaign Package
      • Brand Library
        • Editing Brand Assets
        • Ad Templates
      • General - Flow Settings
        • Reset Your Password
        • Wallet
        • Linking Your Social Media Pages
        • Adding Your Meta Pixel
        • Settings
          • General Section: Organisation, Enquiries, Colors, Address, Partners Settings
          • Users Section: Managing user profiles
          • Channel Configuration Section: Managing linked channels
          • Developer Section: Feed logs, manage Campaign Settings
    • Data Publisher Integration
      • Data Collection Methods
      • Uploading Hashed Files
  • Advertiser Documentation
    • Introduction
    • Navigating the Flow Console
    • Campaigns
      • Publishing Campaigns
      • Monitoring Campaigns
      • Managing Subscriptions
    • Analytics
      • Analytics Dashboards
    • Enquiries
    • General - Flow Settings
      • Reset Your Password
      • Wallet
      • Linking Your Social Media Pages
      • Profile - Your Own Information
  • Changelog
Powered by GitBook
On this page
  1. Publisher Documentation
  2. Integrating with Flow
  3. Analytics API

Campaigns

Last updated 1 month ago

Each campaign will have analytics associated with where it originated from so that they can be associated with specific Branches, Agents, Listings and other External References. This allows relevant dashboards to link the correct campaigns to you.

  • POSTCampaigns by branch
  • POSTCampaigns by listing
  • POSTCampaigns by Agent Email
  • POSTCampaigns by agent external id
  • POSTCampaigns by unique campaign external reference
  • POSTCampaigns by branch
  • POSTCampaigns by listing
  • POSTCampaigns by Agent Email
  • POSTCampaigns by unique campaign external reference
  • POSTCampaigns by agent external id

Campaigns by branch

post

This endpoint retrieves campaign details associated with a specific branch, identified by its branchId. The endpoint returns various details related to campaigns under that branch, such as the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, listing reference, and agent details (including their email, external ID, first and last names).

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
branchIdstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/branch
application/json
post
POST /api/rest/v2/campaigns/branch HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "branchId": "text"
}
200

Responses for POST /api/rest/v2/campaigns/branch

{
  "external_sharing_allFacebookCampaigns_campaignLevel": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by listing

post

This endpoint retrieves campaign details based on a specific listing reference and branch ID. The endpoint returns various details about the campaigns, including the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, and listing reference. It also includes agent details (such as agent email, external ID, first name, and last name) and branch-related information (branch name and external branch ID). This API is useful for fetching campaigns that are tied to a specific listing and branch, allowing for precise filtering and reporting of campaign data.

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
branchIdstringOptional
listingReferencestringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/listing
application/json
post
POST /api/rest/v2/campaigns/listing HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "branchId": "text",
  "listingReference": "text"
}
200

Responses for POST /api/rest/v2/campaigns/listing

{
  "campaignDetails": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by Agent Email

post

This endpoint is designed to fetch campaign details associated with a specific agent by using their email address. It takes in one parameter, agentEmail (String), which represents the email address of the agent. When provided, the endpoint returns various details related to campaigns tied to that agent, including campaign name, start and end dates, campaign type, flow campaign ID, property ID, listing reference, and agent information (such as their email, external ID, first and last names)

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
agentEmailstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/agent/email
application/json
post
POST /api/rest/v2/campaigns/agent/email HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "agentEmail": "text"
}
200

Responses for POST /api/rest/v2/campaigns/agent/email

{
  "campaignDetails": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by agent external id

post

This endpoint is used to retrieve campaign details associated with a specific agent based on their external agent ID. It takes a single parameter, agentExternalId (String), which is the unique external ID of the agent. The endpoint returns various campaign-related information such as the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, listing reference, and details about the agent (including email, external ID, first and last names).

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
agentExternalIdstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/agent/externalID
application/json
post
POST /api/rest/v2/campaigns/agent/externalID HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "agentExternalId": "text"
}
200

Responses for POST /api/rest/v2/campaigns/agent/externalID

{
  "campaignDetails": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by unique campaign external reference

post

this endpoint retrieves campaign details based on a specific external reference ID. The endpoint returns detailed information about the campaign, such as the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, listing reference, and agent details (including agent email, external ID, first and last names)

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
externalrefstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/externalref
application/json
post
POST /api/rest/v2/campaigns/externalref HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "externalref": "text"
}
200

Responses for POST /api/rest/v2/campaigns/externalref

{
  "CampaignData": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by branch

post

This endpoint retrieves campaign details associated with a specific branch, identified by its branchId. The endpoint returns various details related to campaigns under that branch, such as the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, listing reference, and agent details (including their email, external ID, first and last names).

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
branchIdstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/branch
application/json
post
POST /api/rest/v2/campaigns/branch HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "branchId": "text"
}
200

Responses for POST /api/rest/v2/campaigns/branch

{
  "external_sharing_allFacebookCampaigns_campaignLevel": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by listing

post

This endpoint retrieves campaign details based on a specific listing reference and branch ID. The endpoint returns various details about the campaigns, including the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, and listing reference. It also includes agent details (such as agent email, external ID, first name, and last name) and branch-related information (branch name and external branch ID). This API is useful for fetching campaigns that are tied to a specific listing and branch, allowing for precise filtering and reporting of campaign data.

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
branchIdstringOptional
listingReferencestringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/listing
application/json
post
POST /api/rest/v2/campaigns/listing HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "branchId": "text",
  "listingReference": "text"
}
200

Responses for POST /api/rest/v2/campaigns/listing

{
  "campaignDetails": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by Agent Email

post

This endpoint is designed to fetch campaign details associated with a specific agent by using their email address. It takes in one parameter, agentEmail (String), which represents the email address of the agent. When provided, the endpoint returns various details related to campaigns tied to that agent, including campaign name, start and end dates, campaign type, flow campaign ID, property ID, listing reference, and agent information (such as their email, external ID, first and last names)

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
agentEmailstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/agent/email
application/json
post
POST /api/rest/v2/campaigns/agent/email HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "agentEmail": "text"
}
200

Responses for POST /api/rest/v2/campaigns/agent/email

{
  "campaignDetails": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by unique campaign external reference

post

this endpoint retrieves campaign details based on a specific external reference ID. The endpoint returns detailed information about the campaign, such as the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, listing reference, and agent details (including agent email, external ID, first and last names)

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
externalrefstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/externalref
application/json
post
POST /api/rest/v2/campaigns/externalref HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "externalref": "text"
}
200

Responses for POST /api/rest/v2/campaigns/externalref

{
  "CampaignData": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}

Campaigns by agent external id

post

This endpoint is used to retrieve campaign details associated with a specific agent based on their external agent ID. It takes a single parameter, agentExternalId (String), which is the unique external ID of the agent. The endpoint returns various campaign-related information such as the campaign name, start and end dates, campaign type, flow campaign ID, flow property ID, listing reference, and details about the agent (including email, external ID, first and last names).

Header parameters
flow-api-user-idstringOptional

Your flow-api-user-id will be used for authentication of the API request.

flow-api-user-secretstringOptional

Your flow-api-user-secret will be used for authentication of the API request.

Body
agentExternalIdstringOptional
Responses
200
Responses for POST /api/rest/v2/campaigns/agent/externalID
application/json
post
POST /api/rest/v2/campaigns/agent/externalID HTTP/1.1
Host: analytics.flowliving.com
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "agentExternalId": "text"
}
200

Responses for POST /api/rest/v2/campaigns/agent/externalID

{
  "campaignDetails": [
    {
      "agentEmail": "text",
      "agentExternalId": "text",
      "agentFirstName": "text",
      "agentLastName": "text",
      "branchName": "text",
      "campaignEndDate": null,
      "campaignName": "text",
      "campaignStartDate": null,
      "campaignType": "text",
      "externalBranchId": "text",
      "flowCampaignId": "text",
      "flowPropertyId": "text",
      "listingReference": "text"
    }
  ]
}