# Plugin Settings

## Before you start

To pull content from the NPR Story API you'll need an API Key. Please contact [NPR's Member Partnership team](https://nprsupport.desk.com/customer/login) to acquire a key. 

If you are planning to push content to the NPR Story API you'll also need an NPR Story API Org ID. If you are an NPR station or affiliated producer you can find your Org ID at [NPR StationConnect](https://stationconnect.org/login?redirect=%2F). 

If you don't have an Org ID or don't intend to push content into the NPR Story API you can still pull content from the API, but be mindful of the [Terms of Use](https://www.npr.org/about-npr/179876898/terms-of-use).

## Configure your settings

With your API Key in hand, visit the **Settings > NPR API** settings screen in your WordPress dashboard. Enter your API Key, and if available your Org ID.

For the production API, the value for both Pull URL and Push URL is `https://api.npr.org`. If you wish to use the sandbox version of the API for testing, the URL for both Push and Pull is `https://api-s1.npr.org`.

For NPR Pull Post Type you can leave the default or pick a custom post type. You can pull stories into the custom post type to keep them organized separately from your site's regular posts. For example if you select an NPR Pull Post Type of `npr_story_post` you will find all pulled stories in a new dashboard link labelled **NPR Stories**, just below the dashboard link for **Posts**.

For NPR Push Post Type you can leave the default or set it to another post type, like `post`.

If you have configured any Permissions Groups for content you distribute through the NPR Story API you can optionally add them in the NPR Permissions setting. Note that by default all content in the NPR Story API is open to everyone, unless you restrict access to a Permissions Group. For more on setting these up see the [NPR Story API Content Permissions Control page](https://nprsupport.desk.com/customer/en/portal/articles/1995557-npr-api-content-permissions-control).

Once you have all the above entered your settings panel should look something like this:

![NPR Story API plugin settings page with values filled in as described above](assets/img/npr-api-wp-plugin-settings.png)

Hit **Save Changes** and you're ready to start using the NPR Story API.