Skip to main content

Pipedream Integration (API)

Pipedream lets you connect TextCortex with thousands of the most popular apps, so you can automate your work and have more time for what matters most—no code required.

Screenshot 2024-01-14 at 19.45.01.png

In this help center article, we'll show you how to generate an API key on TextCortex dashboard and authenticate your account on Pipedream with your API key.

1) Generate an API key

To generate an API key for TextCortex, follow these steps after logging in: 

1. Go to the API Key page: https://app.textcortex.com/user/dashboard/settings/api-key

4. Click on the Generate API Key button.

5. Copy the API Key to your clipboard.

You'll need this to authenticate your account on Pipedream.

Screenshot 2024-01-14 at 19.24.02.png

 

2) Authenticate your Pipedream connection

Once you have your API key, it's time to insert your API key into the payload inside your request your TextCortex account to Pipedream. You can either use Pyhton or JavaScript.

import requests

def handler(pd: "pipedream"):

 token = f'{pd.inputs["textcortex"]["$auth"]["api_key"]}'

 authorization = f'Bearer {token}'

 headers = {"Authorization": authorization, "Content-Type": 'application/json'}

 data = {"mode": 'voice_passive',"text": 'The sky is blue.'}

 r = requests.post('https://api.textcortex.com/v1/texts/rewritings', headers=headers, json=data)

# Export the data for use in future steps

return r.json()

3) Choose an endpoint

Based on your needs and requirements, you can choose an endpoint and see how you need to structure your request based on our documentation here: https://docs.textcortex.com/api

4) Start sending requests

That's it! Your TextCortex account is now connected via Pipedream, and you can start creating automated workflows to streamline your content generation tasks.

Some popular use cases for this integration include:

  • Creating blog articles to be published on Wordpress
  • Summarizing meeting notes to be published on Slack
  • Rewriting & translating Google Docs documents
  • Running a sentiment analysis on Google Sheets
  • Drafting automatic email replies with Gmail
  • Composing summaries of your Evernote notes

API Error Codes

Cause: Invalid Request

400 - Invalid request
This error code indicates that your request was not structured correctly. This could happen for several reasons, such as:
  • You are exceeding the maximum token limit for the relevant endpoint.
  • You do not have enough input tokens to send a request.
  • You have a typo in the headers you send.

Solution: To resolve this error, please follow these steps:

  • You will see the details of your invalid request in the returned response. Make sure to check them and adjust your request accordingly. 
    • If you are going over the maximum token allowance, the response will provide both the relevant maximum limit and what you currently have in your request.
    • If you do not have enough input tokens to send a request, the response will provide both the relevant minimum limit and what you currently have in your request.

Cause: Invalid Authentication 

  • 401 - API key is not valid
  • 401 - API key does not exist
  • 401 - API key is blacklisted

This error code indicates that your authentication credentials are invalid. This could happen for several reasons, such as:

  • You are using an API key that has been deleted or deactivated.
  • You are using a revoked API key.
  • You are using a blacklisted API key.
  • There is a typo or an extra space in your API key.
  • An old, revoked API key might be cached locally.

Solution: To resolve this error, please follow these steps:

  • Check that you are using the correct API key. You can find your API key in your account settings.
  • If you are unsure whether your API key is valid, you can generate a new one. Make sure to connect your new account with your new API key in your Pipedream authentication.
  • Try clearing your browser's cache and cookies, then try again.

Cause: Not enough credits

  • 402 - Not enough credits

This error code indicates that your authentication credentials do not have sufficient credits to send any more requests.

Solution: You can see your API usage and your remaining credits in your API key settings. When you run out of credits, you can add more credits in the same dashboard.

Cause: The server had an error while processing your request

  • 500 - The server had an error while processing your request

This error code indicates that there is an issue on our servers.

Solution: Retry your request after a brief wait and contact us if the issue persists at contact@textcortex.com. You may also check the status page.

Integrating Pipedream with TextCortex allows you to automate your content generation, saving you time and effort. By following the steps outlined in this article, you can easily generate an API key for TextCortex and authenticate your account on Pipedream. Start exploring the possibilities of automation and improve your content management process today!

For detailed information on TextCortex API, please refer to the following documentation: https://docs.textcortex.com/api

Was this article helpful?