Village Product and Developer Docs
  • 📘Welcome to Village Labs
    • Welcome to Village Labs
    • Self Service Onboarding
    • Help Pages
      • Adding and Deleting Users
      • Mapping Users to Source tool IDs
      • How to follow or unfollow other users
      • Configuring & Removing Daily Slack Notification Whitelist
      • Changing the Reporting Lines & Teams
      • Following Custom Reports
      • Google Drive Privacy: When will my documents appear in Village Reports?
    • Custom Reports
      • Creating Team Reports
      • Creating Custom Reports & Custom Prompt Library
    • Meetings
      • Connecting your Calendar
      • Configuring your Meetings
      • Meeting Summary Reports
    • Village Assistant
      • Github PR Review Tool
    • Security & Compliance
    • Data Privacy & Permissions
  • 🔌Data Connections
    • Airtable
    • Ashby
    • Clickup
      • Finding ClickUp User IDs
    • Figma
    • Github
      • Finding GitHub User IDs
    • Gitlab
    • Google - OAuth (Recommended)
    • Google - Manual Connection
    • Hubspot
    • Jira
      • Finding Jira User IDs
    • Confluence
      • Finding Confluence / Jira User IDs
    • Linear
    • Asana
    • Monday
    • Notion
    • Pipedrive
    • Slack
    • Basecamp
    • Zoom
  • 👩‍💻Legacy Developer Docs
    • Developer Quickstart
    • Village APIs: Introduction
      • Activity API
      • User Status API
      • Patch User API
      • Segments API
      • Redemption API
      • Master Award Controls
      • Connections (Referrals) APIs
      • GET APIs
    • 3rd Party Payments Integrations
    • Embedding Village Dashboards
  • 🕵️LEGACY Knowledge Base
    • Admin Quickstart
    • Referrals Support
    • The Basics of Village in 15 Minutes
    • Programs & Rules
      • Triggers
        • Activities
        • Goals
      • Conditions
        • Segment Conditions
        • Time Conditions
        • Max Budget Conditions
        • Conditional Multipliers
    • Awards
      • Monetary (Cash) Awards
      • Non-Monetary Awards
        • Funding
          • In-depth use cases for funding pools
      • Badges & Statuses
      • Award Expiration
    • Segments
      • Segmentation Use Cases
    • Rule Evaluation Logic Deep-dive
    • The Village Dashboards
      • Admin Account Creation
      • User Access Management
      • Network Settings
      • User Dashboard
    • BigQuery
    • Managing Payment Integrations
    • Referrals (Connections)
      • Pre-populating Users' Unique Referral Codes In Signup Flows & Forms
  • No and Low Code Solutions
    • No and Low Code Solutions
      • No & Low Code Solutions
  • Feedback
    • Village Docs Feedback Form
    • Feature Requests
    • Talk to our Team
Powered by GitBook
On this page
  • Note: These docs are still actively supported, but are considered Legacy as most of this content is no longer required by admins.
  • Quickstart: Administrators
  • What is Village?
  • Creating an Admin Account
  • Creating a Network
  • Invite Users
  • Invite Your Team
  • Invite Your End Users
  • Customize Your Network
  • Create Your First Program
  • Creating Fun Points
  • Create the "Dance Completed" Activity
  • Create the Team Fun Initiative
  • Creating Our First Rule
  • Bonus: Creating Our First Comms
  • Suggested Next Steps
  • More on Connecting Your Data to Village
  • The Village API
  • Low or No Code Data Upload
  • Third Party Data Connections

Was this helpful?

  1. LEGACY Knowledge Base

Admin Quickstart

How to get started on Village in record time.

PreviousEmbedding Village DashboardsNextReferrals Support

Last updated 10 months ago

Was this helpful?

Note: These docs are still actively supported, but are considered Legacy as most of this content is no longer required by admins.

Quickstart: Administrators

This quick-start guide is for Village Administrators, and introduces you to the key concepts of the Village Admin Dashboard.

Here you will learn:

  1. and why you should use it

  2. How to create a , the representation of your business on Village

  3. How to to your network

  4. How to your network

  5. How to create your first

  6. How to make your first to Village

The purpose of this guide is to get you set up in Village as quickly as possible.

We also recommend reading , and other sections of this the to understand Village in more depth.

To learn about Village through different use cases, you can also check out our Guides.

What is Village?

Village is the brain of your business.

We turn any user on your platform into a power user by driving the right behavior at the right time.

Create and automate cash and non-monetary awards, credits, promos, referrals, goals, milestones, status, points, benefits, revenue share, and more — as well as powering the segmentation, comms and distribution of these incentives in the most efficient and effective way possible.

Village means more revenue, fewer costs, and, most importantly, a much stronger long-term relationship with your users.

Creating an Admin Account

Village is invite-only. If you'd like an invitation to use Village, reach out to our team at hello@villagelabs.co

You will receive an email invite to Village:

Click the link to accept the invite. You can log in through a third party or create an account with an email/password pair.

You must use the email that received the invitation, otherwise you will not be authorized to create an account and Village Network.

Creating a Network

A Village Network is the representation of a business, organization, or platform within Village.

Your first step should be to create a Network.

You can only create one Network within Village by default. If you have any issues creating a network, or require additional networks, please reach out to support@villagelabs.co.

To create a Network, click on "Launch a Network."

Enter the required info:

Important: You cannot change your Unique Name once it's created. Although this is only used by your development team, please take care when creating it!

ID
Input
Description

1

Display Name

This is the user-facing name for your network, typically the name of your platform or company, e.g. "Nike."

2

Unique Name

This is a non-editable, unique identifier for your network. This will not be seen by users or customers, but will be used by your developer team to access the Village APIs. You cannot change this once your network is launched.

3

Description

This is a user-facing description, often the company description or tagline. It may be user-facing in some instances.

Review the information you've entered and click "I Want to Launch" when ready.

Invite Users

There are two distinct user roles within your Village Network: 'Admin' and 'User.'

Admin Role

These are your team members. Admins have the ability to create and manage incentive structures, send comms, invite users, or configure your Network settings.

User Role

These are the end-users of your platform or business. Users could include customers, suppliers, workers, contractors, freelancers, etc. They can only access the End User Dashboard, which admins control the contents of.

Invite Your Team

Let's start by inviting your team members – your fellow admins.

Navigate to Side Menu -> Users -> Invites -> Add (+).

You can only add users of one type at a time. Select the Role you want to give (Admin for your team members), and enter as many emails as you like.

Once they're invited, they'll go through the same account creation process you did. But instead of creating a Network, they'll already have the option to "Manage Network" for the Network you invited them to.

Invite Your End Users

Bulk invites: Want to add a lot of users?

If you need to bulk invite tens, hundreds, or thousands of users at once, reach out to our team at support@villagelabs.co. We'll work with you to backfill your existing user base.

To invite your end-users (suppliers, customers, partners, etc.), you can go through the same process, just make sure to set the role to "Member" instead of admin.

Automatically Invite Users: User Status API

This is typically the most efficient way to create users on an ongoing basis, such as auto-creating a Village account as soon as they sign up on your platform.

Customize Your Network

Bring your company's brand to Village! You can:

  1. Change the color scheme of the end-user dashboard

  2. Edit your user-facing Network name

  3. Add a company logo that will appear on the admin and end-user dashboards

    1. We recommend a logo with a white background. Logo must be 2:1 (e.g. 250 px by 500 px) for best results.

Click the pencil icon on the Network Manager title widget to access Network customization features.

Create Your First Program

  • Check out our Guides to learn through different use cases ->

To get started, we will create a test Program. This program will create incentives for our team to have more fun. Here's the order of what we're going to do:

Creating Fun Points

Before we can create an incentive, we need something to award. First, navigate to Side Menu -> Incentives -> Awards -> Non-Monetary Awards -> New Non-Monetary Award. Don't worry - we can hide or delete these later.

Create the "Dance Completed" Activity

Next, we need a user Activity that we want to award with Fun Points. Once we've set this up, we can use this Activity to trigger our Rule, and issue an Award (Fun Points).

Navigate to Side Menu -> Incentives -> Triggers -> Activities -> New Activity Trigger.

Create the Team Fun Initiative

Rules are the backbone of your Village automations. They execute output operations – like issuing Awards or adding/removing users from segments – based on business logic.

But first, all Rules need to be grouped by Programs. Navigate to Side Menu -> Incentives -> Programs -> Create New Program.

Creating Our First Rule

Now that we have a Program, I can navigate to Programs -> Draft Programs -> Manage Team Fun Initiative -> Create New Rule.

Now selecting from the dropdowns:

  1. Name: Dance Award

  2. Trigger Type: Action

  3. Trigger: Dance Completed

  4. Award: Fun Points

  5. Amount: 1

  6. Recipient: Primary Dancer

Test Your Rule! See Fun Points In Action.

Log a "Dance Completed" Activity to Trigger your Rule!

This section requires some light code using your terminal window, but this should be relatively straightforward, even for non-technical people.

To see your new incentive program in action, get an API key and send Dance Completed Activity to the Village Activity API.

Get an API Key

To get an API keys, navigate to Network Manager -> API Token and Documentation -> Create New Key.

Run a cURL Command to hit the Village API

Here's an example. Open the terminal window on your device, edit the cURL command below with your actual Network ID and API Key, then copy/paste it into the command line interface and log your own epic dance party!

//Replace 'YOUR_API_KEY' with your actual API key
//Replace 'YOUR_NETWORK_ID' with your actual Network ID 
//Replace 'YOUR_EMAIL' with your email

curl -X POST https://api.villagelabs.co/networks/YOUR_NETWORK_ID/activity \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
    "activity_short_id": "dance-completed",
    "amount": "1",
    "users": {
        "primary_dancer": "YOUR_EMAIL",
    },
    "metadata": {
        "reference_id": "abc123",
        "description": "It was an epic dance party."
    }
}'

See the Results

When the Activity is reported successfully, you'll see 1 Fun Point in your wallet.

Bonus: Creating Our First Comms

Village can automatically create personalized comms that explain how programs and/or rules work in a simple and engaging way your end users. These can be sent by Village on behalf of your platform, or through your existing 3rd-party CRM provider.

Here's an example of an email automatically generated based on the program and rule above:

Suggested Next Steps

Suggested Next Steps:

  1. Visit our Guides to learn about Village through examples ->

More on Connecting Your Data to Village

The Village API

Our RESTful API listens for events and activity on your platform and enables real-time Rule execution.

Only events and activity that have been configured as Triggers within Village will be securely passed to Village through the API. These Triggers are in turn used to start the evaluation of your rules logic within Village. To read more about setting up, configuring, and using the API, refer to our Engineering Documentation, or read more about Triggers here.

Low or No Code Data Upload

You can use our quick and dirty Python, Airtable, and Google Apps Scripts. These are ideal if you're initially testing an integration, if your data is not stored in a centralized database, or if you're just getting started.

Third Party Data Connections

Data Connections

Village also has many one-click data connections for securely sharing events based data to be linked to triggers within the platform. These can be accessed in Village's production environment through the Data Connections tab.

In most cases, these connections are the easiest way to pass data to Village using common data sources and platforms

We currently support the following data connections with many more being added - please ping support@villagelabs.co if you don't see your data source listed.

Productivity Tools

  • Google Sheets

  • Airtable

  • Zapier

  • Github

  • Slack

Payments

  • Stripe

  • Paypal

Databases & Warehousing

  • Bigquery

  • MySQL

  • PostgresSQL

  • Snowflake

  • Amazon Redshift

Cloud Storage

  • Amazon S3

  • Google Cloud

  • MongoDB

CRM & Sales

  • SendGrid

  • Hubspot

  • Intercom

  • Pipedrive

  • Salesforce

  • Mailchimp

You'll be redirected to the , your home base within Village, where you can invite users, create incentives, send communications, and manage the ongoing analytics of your network.

For all non-admin users, you can skip manual invites and use the . This allows you to automatically invite your users to the Village Network.

: Fun Points

: Dance Completed

: Team Fun Initiative

: 1 Fun Point for per Dance Completed

Then click the launch button on the Rule. Finally, launch the Program (note: Programs are held in draft mode until they have at least one Rule ready to go live).

This feature is in beta right now, please if you'd like access.

🕵️
🚀
🚀
More about creating accounts ->
Network Manager
See more at User Access Management ->
User Status API ->
Knowledge Base for Programs & Rules ->
More on the backbone of Village, Programs & Rules ->
send us a request
Read 'The Basics of Village in 10 Minutes' to see what else you can do ->
Connect your data to unlock Village. Connect the Activity API ->
API Docs ->
Low or No Code Data Upload ->
Looking for the Developer Quickstart? Go here ->
'The basics of Village in 10 minutes'->
Knowledge Base
About Village
Network
Invite Users
Customize
Programs & Rules
Data Connection
Skip to the setup steps ->
Create an Award
Create a Trigger
Create a Program
Create a Rule
[optional] Try it out
Creating and sending an incentive with Village.
A love story in the making
Accept your invite
Create an account
Launch Network
Launching your network
User Access
Navigate to Non-Monetary Awards
Create some Fun Points
Create a New Trigger
Dances are fun
Program Overview -> Create New Program
Encouraging more fun
Creating a draft rule
Comms generated based on the rules you created.
Village connects to many 3rd-party data sources.