Create an open API.

  • 49
  • Idea
  • Updated 3 years ago
  • Implemented
Archived and Closed

This conversation is no longer open for comments or replies and is no longer visible to community members.

Let others develop apps that utilize the OBD interface that you setup and your device hardware. Just like how Nest is opening an API for their thermostats.
Photo of Mike McCoy

Mike McCoy

  • 554 Points 500 badge 2x thumb

Posted 5 years ago

  • 49
Photo of Amy


  • 68,970 Points 50k badge 2x thumb
Official Response
Thanks everyone for your passionate feedback about the need to easily access the information that the Automatic app gives you. We agree that it would be really useful! You can now access the data and build amazing apps with the Automatic API. While an API has always been on the roadmap, we expedited its development following the feedback from all of you.

You can find more information about how you can start using the API at the end of this post, but here are some important things you should know about the API.

  • It's currently in alpha, so we'd appreciate your patience as you use it to build your apps. We decided that we'd rather get it to you earlier and iron out the kinks over time instead of making you wait longer.

  • Again, this is in alpha so things could change that may break your app.
    If this scares you, you should wait until we have things more stable
    before investing time in building an application.

  • Some aspects of the API require an update to the iOS app (event webhooks). This version of the app will be submitted to the app store soon and should be available in a couple of weeks, but you can simulate the same events generated by the app in the developer portal for your testing.

  • The Android app, which is currently in beta does not support event webhooks. We don't have a timeline for when it will be available.

+++Here are the details you need to get started with the API:+++

API Documentation

We'll keep it updated as it improves.

Sample Applications

This node.js app uses oAuth to allow automatic users to sign in and
view their trips. It also has functions to allow exporting of trips.
You can see this app live at

A node.js app to test and demonstrate the use of webhooks. After
signing in with oAuth, users see a map that is updated with markers
based on events sent by Automatic. You can see this app live at - there is a button that will
send test events to the client, so you can see what would happen if
you were actually driving

Getting an API Key

Log in with your automatic account at:

From here you can request an API key.

API Status

The REST endpoints (for getting trip summaries)
Webhooks for trip:finished and parking:changed.

Coming in late January:
The rest of the webhook events

Building an App

We'd love to see what you build using the api - some ideas to get you started:

* make graphs of trip frequency, miles driven, mpg, etc using the
REST trip summary endpoint
* an app that sends your family a text every time you arrive at work
(using the webhook trip:finished event and the lat/lon provided)
* Auto-checkin on fourquare when you arrive at home (trip:finished
webook event based on end location)
* An app that compares your driving to someone elses (requires you to
keep track of users and ask their permission to share data between

API Support and Feedback

We want feedback: you can email with any
questions, suggestions or issues. If something in the documentation
isn't clear, or if anything with our implementation isn't awesome, let
us know and we'll make it right.
Photo of Amy


  • 68,970 Points 50k badge 2x thumb
Official Response
Here's a video of an API integration Nate did with Automatic & Hue light bulbs. Super cool!
Photo of Amy


  • 68,970 Points 50k badge 2x thumb
Official Response
I want to be sure everyone in this topic is aware of our channel on IFTTT, which allows you to make If This Then That recipes with Automatic and other apps that are also on IFTTT.

Read more about it here