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 API connections are no longer required except in edge use cases to take advantage of Village Labs.
  • You are Here
  • Connecting to Village
  • Generate an API Key
  • Recommended Quickstart Next Steps:

Was this helpful?

  1. Legacy Developer Docs

Developer Quickstart

Integrate with the Village API to unlock the power of Village

PreviousZoomNextVillage APIs: Introduction

Last updated 1 year ago

Was this helpful?

Note: These docs are still actively supported, but are considered Legacy as most API connections are no longer required except in edge use cases to take advantage of Village Labs.

You are Here

Jump to API Docs:

  • Postman Collection ->

  • Village API Intro ->

  • Activity API ->

  • User Status API ->

  • Segments API ->

  • Redemption API ->

  • Master Award Controls (Issue, Burn, Exchange, Transfer) ->

  • Connections (Referrals) API ->

  • GET APIs ->

Looking for something else?

  • Learn about the product with Admin Quickstart ->

  • Low and No-Code Solutions ->

Connecting to Village

Enable Village to execute Rules in real-time, you need to connect your system to Village through Village's API.

Generate an API Key

Prerequisites:

  1. An Admin Account (Invite Users & Admins ->)

  2. A Network (Create a Network ->)

Note on API Asynchronous Responses:

Due to our system's asynchronous processing architecture and cryptographically verifiable ledger, our POST APIs utilize an API Results Table and a GET Results API to display errors and other information related to API requests.

The real-time response code you do receive from a Village POST API request represents whether or not your request has been added to our asynchronous processing queue, not whether the POST request and any downstream Programs & Rules were fully process without errors.

To view downstream processing errors and other information related to your POST requests, use the API Results Table and a GET Results API.

Once you've created a network and have an administrator account, you can generate an API key and begin the integration process.

From the Side Menu of your Network Admin view, navigate to "Manage Network" --> "API Tokens & Documentation."

Caution: Village API keys allows privileged access to your Network and any funds you have allocated to your Network's connected bank account and treasury. Make sure you keep it secure.

Caution: The key will be shown only once and cannot be shown again.

Click "Generate New Key", fill out the fields below, and click "Generate":

The key will be shown only once and cannot be shown again, so be sure to transfer it to a secure location. In the event your keys are lost or stolen, they should be immediately deleted and replaced with new keys.

Recommended Quickstart Next Steps:

  1. Connect your data with the Activity API ->

  2. Check out the Village API Intro -> for general Authentication & Response references

  3. Connect your user signup flow to Village using the Use Status API ->

Is this page helpful? Give us feedback on our docs ->

👩‍💻
👇
Connecting to Village
The Village System