Meetings are added to the app by establishing an ongoing connection between this site and an official area website. Use this checklist to determine your eligibility.

Why Can't We Just Email You the Data?

We don't accept manual uploads of data because it's our priority that the app maintain accuracy over the long term. We don't want our users relying on sporadic updates.

Checklist

We only sync with AA intergroups, General Service Areas, and Districts. We don't connect to individual groups, outside entities, or other programs.

We only list meetings for entities that want to be listed. Sometimes it's a Central Office Manager or webmaster that gives us permission, sometimes it's a product of a group vote.

The organization must have a website so that we can sync up with it. We don't accept manual submissions of data (such as a PDF or spreadsheet).

The site must manage its own database for us to sync up, with separate fields for things like meeting name, day, and time. It can be hard to tell from the outside if a site is using a database. The surest way is to ask the webmaster.

If the site is using the 12 Step Meeting List for WordPress (described below), then this is provided automatically.

If not, then see the 'Not Using WordPress?' section below, we'll need to set up a hidden list of meetings for the app to read. This is easy and only requires setup once, and then the connection can work forever. Get in touch, we are happy to help set it up.

The final step is to let us know about the site! We add them from our end and then meeting data starts showing up in the app.

One Easy Way to Connect

We developed a free WordPress plugin called 12 Step Meeting List that helps you manage your meetings on your website and displays them in a searchable list and map. If you're already on WordPress, or considering it, then this is a great way to get started quickly. Once you're set up, simply contact us and we will add you to the app. Once you're added, there's no effort required other than keeping your website updated. Your changes will flow out to the app automatically.

About 75% of the areas we serve are using this plugin, places such as New York, Austin, and San Jose. Want to know more? Check out the plugin's page on the WordPress plugin directory, and watch this short screencast video on how to set it up.

Not Using WordPress?

If you prefer to use another system, that's no problem. About 25% of the areas we serve are using custom systems, places such as Los Angeles, Ottawa, and Annapolis. We'll just need to do a little work at first to get you set up, but after that there's no ongoing maintenance required. You simply continue to update meetings normally and the changes will flow out to the app.

The goal is to make a script that outputs your meetings as a simple array in JSON format. It should look something like this:

[
	{
		"name": "Sunday Serenity",
		"slug": "sunday-serenity",
		"day": 0,
		"time": "18:00",
		"location": "Alano Club",
		"group": "The Serenity Group",
		"notes": "Ring buzzer. Meeting is on the 2nd floor.",
		"updated": "2017-05-31 14:32:23",
		"url": "https://intergroup.org/meetings/sunday-serenity",
		"types": [
			"O",
			"BB"
		],
		"address": "123 Main Street, Anytown, OK",
		"region": "Downtown"
	},
	...
]

Don't worry if your system doesn't have all these fields, just contact us with what you have, and we will work together to figure it out. The minimum fields that are required to list a meeting in the app are name, slug, day, time, and enough address information to find it on a map.

Here is a live example JSON file as a reference. To test your feed, try our validator. For detailed information about the spec, as well as sample starter scripts, check out the Meeting Guide API on GitHub.

What If My Area Doesn't Have a Database?

Please get in touch. We are happy to help you set up a free, modern meeting finder using WordPress.

In several cases, we've created a standalone meeting finder in WordPress that matches the appearance of a website on another platform.