DEV Community

Cover image for A Simple CLI for Convertkit
Zell Liew 🤗
Zell Liew 🤗

Posted on • Originally published at zellwk.com

A Simple CLI for Convertkit

When I need to check a person's details on Convertkit, I need to log in to Convertkit and search for the person's email address. This process takes time, energy, and clicks.

I'm not in the state to check a website when I'm doing work. I want to find the person's information quickly and get stuff done.

So I created a command line interface for Convertkit.

Note: Links to Convertkit in this article are affiliate links. Feel free to use them if you want to support me a little bit :)

The Convertkit CLI

The Convertkit CLI lets you do four things:

  1. Get information about a subscriber
  2. List tags
  3. Add a tag to a subscriber
  4. Remove a tag from a subscriber

Installing the CLI

You can install the CLI with npm:

npm install convertkit-cli -g
Enter fullscreen mode Exit fullscreen mode

This lets you use the ck command.

Logging in

You need to provide your API Secret for the Convertkit CLI to work. You can find the API Secret on your accounts settings page.

Your API Secret is kept safe in your computer, so don't worry about it leaking out :)

You use the login command to provide the API Secret.

ck login <API_SECRET>
Enter fullscreen mode Exit fullscreen mode

Getting information about a subscriber

You can use the subscriber command to get information about a subscriber.

ck subscriber <email>
Enter fullscreen mode Exit fullscreen mode

This returns the following information:

  1. Name
  2. Email address
  3. State
  4. Date created
  5. Tags

Gets a subscriber.

Listing Tags

You can use the tags command to list tags.

ck tags
Enter fullscreen mode Exit fullscreen mode

Gets list of tags.

Tagging a subscriber

You can use the tagsub command to tag a subscriber. The tagsub command contains two subcommands.

  • add: Adds a tag to a subscriber
  • remove: Removes a tag from a subscriber

To tag a subscriber, you use tagsub add.

ck tagsub add <tag> <email>
Enter fullscreen mode Exit fullscreen mode

Adds tag to subscriber

Removing a tag from a subscriber

To remove a tag from a subscriber, you use tagsub remove.

ck tagsub remove <tag> <email>
Enter fullscreen mode Exit fullscreen mode

Removes tag from a subscriber

Contributions welcome!

This CLI is in an early stage draft. It's not perfect yet. But I want to push this out so people (other than myself) can use it.

Here's the Github repository if you want to contribute some code :)


Thanks for reading. This article was originally posted on my blog. Sign up for my newsletter if you want more articles to help you become a better frontend developer.

Top comments (0)