> ## Documentation Index
> Fetch the complete documentation index at: https://docs.woopsocial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Onboarding

## Regular API Setup

1. Copy your API key from the platform (need a new one? [<u>Get your API key here</u>](https://app.woopsocial.com/api-access))
2. Connect one of your social media accounts to WoopSocial (click Connect Accounts [<u>in the WoopSocial Dashboard menu</u>](https://app.woopsocial.com/) or [<u>create an OAuth URL</u>](https://docs.woopsocial.com/api-reference/social-accounts/generate-oauth-url))
3. Use the <a href="/api-reference/projects/list-projects?playground=open" target="_blank" rel="noopener noreferrer"><u>List projects playground</u></a> to determine your project's ID (you can also copy your project ID from the top-left Project dropdown in the platform after you've finished onboarding).
   1. Enter your API key from step 1 into the "Authorization" field
   2. Click on the "Send" button. If the request is successful, it will list your projects' IDs and names. Copy one of the IDs, you will need it for the next step.
4. Many social platforms require a photo or video to publish a post. Use the <a href="/api-reference/media/upload-media?playground=open" target="_blank" rel="noopener noreferrer"><u>Upload media playground</u></a> to upload your file.
   1. Enter the project id from the previous step in the `projectId` field.
   2. Select a file in the `Body` section of the form.
   3. Click "Send" and copy the returned media ID, which you will need when submitting a post.
5. Run ‘[<u>Get social accounts</u>](https://docs.woopsocial.com/api-reference/social-accounts/list-social-accounts)’ or copy your social account ID from the "Connect Accounts" pop-up in the platform. You will need this social account ID to schedule a post.
6. Use the <a href="/api-reference/posts/create-post?playground=open" target="_blank" rel="noopener noreferrer"><u>Create post playground</u></a> to schedule a post.
   1. Choose your targeted social platform and programming language in the top-right corner of the playground form.
   2. Fill in the required values on the left-hand side including the `mediaId` acquired previously (unless you are submitting a text-only post).
   3. Click the "Send" button to schedule the post.

Issues? Just use the chat button in the bottom right and we’ll help you out.

## Zapier setup

1. Create a new Zap → Search for “WoopSocial”
2. Click “Account” and “Connect WoopSocial”/”Sign in”
3. Enter your API key (go here to create a new one if needed) → Connect
4. Select “Create a new social media post” → Continue
5. Select your Business Profile and your Social Media Account(s)
6. Choose a Selected Time or type “Now”
7. Enter the Post Content and select a Media File if needed → Continue
8. Click “Test Step”

Issues? Just use the chat button in the bottom right and we’ll help you out.

## n8n setup

1. Create a new workflow → Search for “@woopsocial/n8n-nodes-woopsocial”
2. Connect it by entering your API key
3. Set up new modules to get your project ID (or go to the dashboard and go to the dropdown in the top left to copy it)
4. Grab your social account ID (or copy it from the Connect Accounts modal in your dashboard)
5. Set up a new “Create a social media post” module
6. Enter your Project ID and Social Account ID(s)
7. Enter your post content and add an optional media file
8. Test it by publishing a new post

Issues? Just use the chat button in the bottom right and we’ll help you out.