With the implementation of MailChimp’s 3.0 API in the WP-Members MailChimp extension (in version 2.0), the API playground will be a useful tool for testing and working with your list.
This document describes using the playground to check if users are on the list or not.
When testing, you may find that you are using the same email address multiple times for testing. If this email address becomes unsubscribed but not deleted from the list, you will not see it when you view your list details in MailChimp, but it may actually still be on the list. This can lead to some confusion when testing since you may run a test and not receive a confirmation message and suspect that there is something wrong with the extension or with MailChimp. In this case it will be necessary for you to view your list details in the API Playground to determine if this user is on the list in an unsubscribed state or not, and if so, delete the email.
When using the API Playground, keep in mind that this is NOT a sandbox. It is real live data on any list you are viewing in the playground, and as such any changes or updates you implement are real. If you delete a live user from a live user in the playground, this is a real action. This is unlike a sandbox that may be used for testing on test data, so keep that in mind when using the playground.
Enter the Playground
To use the MailChimp API Playground, go to http://developer.mailchimp.com/ and select “Get Started” under the heading “Playground”. This will bring you to the Playground entry point where you will need to enter an API key to enter the Playground and manage your lists. You can use an API key specifically for Playground use or you can use your API key that you set up for connecting the WP-Members MailChimp extension to MailChimp. Unless you have a need to keep track of transaction data based on API key, it does not matter what key you use.
Manage Your List
Once you’ve entered your API key and are in the playground, you can do a number of things with the API. For the purposes of this troubleshooting article, we are just managing list users, so select “Lists” from the list of choices.
Then you will want to select the list you want to work with. Some users may have a test list specifically for testing, others may test with their actual list. Whatever works for you is fine. You’ll need to select the list you are testing with.
Viewing List Members
Now that you are in the list, you can manage members of the list. The initial view when you select the list in the previous step will be general list information – your list ID, the list name, contact info, etc. To the right you will see some menus.
From the Subresources menu, select “members”.
Now you should be viewing members of the list. This may be a long list if you are working with a live list and have a lot of users. If this is a test list, it might be one (or zero). It depends on the list.
We’ve been talking about checking if an email that you are using for testing is on the list or not. You may see that email address on this screen. If you do and the email does not appear when you view the list subscribers in MailChimp, then the address is on the list in an unsubscribed state and you need to delete it in order to continue testing with it as if it were a new email address.
To check the details of this email address, you can either click the actual email address in the list (as indicated by the red arrow in the image below) or you can use the “Actions” menu to the right.
Selecting “Edit” from the “Actions” menu will tell you the “status” of the address in the list (among other things). The status could be any of the following:
If the address is pending, it has not acted on a double opt-in action. If it is unsubscribed, the user was unsubscribed but not deleted.
To delete the user, select “delete” from the “Actions” menu. This will completely remove the address from the list and the address can now be used again for testing.