segmentio · markzegarelli · Jan 14, 2022 · Jan 13, 2022 · Jan 14, 2022 · Jan 14, 2022
@@ -166,8 +166,7 @@ const updateSources = async () => {
   const hiddenSources = [
     'amp',
     'factual-engine',
-    'twilio-event-streams-beta',
-    'mixpanel-cohorts'
+    'twilio-event-streams-beta'
   ]
 
   sources.forEach(source => {

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
-# destination categories last updated 2022-01-13 
+# destination categories last updated 2022-01-14 
 items:
 - display_name: A/B Testing
   slug: a-b-testing

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
-# destination data last updated 2022-01-13 
+# destination data last updated 2022-01-14 
 items:
 - destination_id: 60b5d0a01f3726b85dc05aab
   display_name: 2mee

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
-# source cateogries last updated 2022-01-13 
+# source cateogries last updated 2022-01-14 
 items:
   - display_name: A/B Testing
     slug: a-b-testing

@@ -1,5 +1,5 @@
 # AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
-# sources last updated 2022-01-13 
+# sources last updated 2022-01-14 
 items:
   - id: 8HWbgPTt3k
     display_name: .NET
@@ -607,7 +607,7 @@ items:
     display_name: Mixpanel Cohorts
     slug: mixpanel-cohorts
     url: connections/sources/catalog/cloud-apps/mixpanel-cohorts
-    hidden: true
+    hidden: false
     source_type: cloud-app
     description: >-
       Mixpanel helps teams get answers to product questions by providing fast,

@@ -1,4 +1,47 @@
 ---
 title: 'Mixpanel Cohorts Source'
-hidden: true
----
+---
+
+
+[Mixpanel Cohorts](https://help.mixpanel.com/hc/en-us/articles/115005708186-Cohorts-Overview-){:target="_blank} are groups of users defined by a set of criteria. The Mixpanel Cohorts Source allows you to export Cohorts of users from Mixpanel to Segment so that you can better target users across many downstream connections. You can sync Cohorts of users to your Segment-connected raw data warehouses and downstream destinations that accept Segment identify events.
+
+This source is maintained by Mixpanel. For any issues with the source, contact the [Mixpanel Support team](https://help.mixpanel.com/hc/en-us/requests/new){:target="_blank"}.
+
+## Getting Started
+
+1. From your workspace's [Sources catalog page](https://app.segment.com/goto-my-workspace/sources/catalog) click **Add Source**.
+2. Search for **Mixpanel Cohorts** in the Sources Catalog and click **Add Source**.
+3. On the next screen, give the Source a nickname and configure any other settings. 
+4. From the new Source’s Overview page, copy the Segment WriteKey
+5. To export users from Mixpanel to Segment, in Mixpanel first Connect Your segment workspace in  integrations page add add the copied WriteKey in the **API KEY** field and give the connection a desired name in **CONNECTOR NAME** field. ![Add the connector name](images/connect.png)
+6. Once connected you can go to mixpanel cohorts page and export any cohort to the connection.![Export cohorts](images/export.png)
+7. Once configured, Cohorts sync to Segment based on the sync schedule in Mixpanel. For more information go to [Mixpanel Segment Integration documentation.](https://help.mixpanel.com/hc/en-us/articles/4408988683156-Segment-Integration){:target="_blank"}
+
+
+
+## The Cohort sync process
+
+Mixpanel sets a property on the user's profile in Segment indicating whether they are currently part of the cohort.
+
+The following identify call to Segment when a user enters the cohort:
+```json
+{
+  "type": "identify",
+  "traits": {
+    "Mixpanel - <Cohort Name in Mixpanel>": true,
+  },
+  "userId": "[email protected]" // mixpanel uses the distinct_id property here
+}
+```
+
+
+Mixpanel sends the following identify call when a user exits the cohort:
+```json
+{
+  "type": "identify",
+  "traits": {
+    "Mixpanel - <Cohort Name in Mixpanel>": false,
+  },
+  "userId": "[email protected]" // mixpanel uses the distinct_id property here
+}
+```