# Ritekit

RiteKit offers a suite of APIs designed to enhance social media engagement by providing tools for hashtag generation, link shortening, and content analysis.

- **Category:** social media marketing
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 15
- **Triggers:** 0
- **Slug:** `RITEKIT`
- **Version:** 20260312_00

## Tools

### Auto Hashtag

**Slug:** `RITEKIT_AUTO_HASHTAG`

Tool to automatically add relevant hashtags to a given post. Use when you have plain text and need suggested hashtags appended or inserted in context.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `post` | string | Yes | Text of the post to add hashtags to |
| `maxHashtags` | integer | No | Maximum number of hashtags to add (default is 2) |
| `hashtagPosition` | string ("auto" | "end") | No | Position of hashtags: 'auto' to insert in context, 'end' to append at end (default is 'auto') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Banned Instagram Hashtags

**Slug:** `RITEKIT_BANNED_INSTAGRAM_HASHTAGS`

Tool to identify which hashtags are banned on Instagram. Use when preparing content and need to filter out banned hashtags before posting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | Yes | List of hashtags to check (without the leading '#'), 1-100 items |
| `client_id` | string | No | RiteKit API client ID passed as 'client_id' query parameter (alternative to access_token) |
| `access_token` | string | No | RiteKit OAuth2 access token passed as 'access_token' query parameter |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Detect Disposable Email

**Slug:** `RITEKIT_DETECT_DISPOSABLE_EMAIL`

Tool to detect if an email address is disposable. Use when validating email addresses to filter out temporary or fake email services.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to check for disposable status |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Detect Email Typo

**Slug:** `RITEKIT_DETECT_EMAIL_TYPO`

Tool to detect common typos in email addresses and suggest corrections. Use when validating email input to help users correct mistakes like gml.com -> gmail.com.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to check for typos and get correction suggestions |
| `client_id` | string | Yes | Your RiteKit API client ID; must be passed as 'client_id' query parameter |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Free Email Detection

**Slug:** `RITEKIT_FREEMAIL_DETECTION`

Tool to detect whether an email address belongs to a free email provider. Use when validating lead quality before ingestion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to check for free-email provider |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Access Token

**Slug:** `RITEKIT_GET_ACCESS_TOKEN`

Tool to obtain a RiteKit access token. Prefer using a stored token from connection metadata or request. Falls back to OAuth2 client credentials if both client_id and client_secret are provided and no token is otherwise available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | No | Optional RiteKit API client ID. |
| `access_token` | string | No | Optional access token. If provided, the action will return this token without making a network request. |
| `client_secret` | string | No | Optional RiteKit API client secret. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### RiteKit Get Client ID

**Slug:** `RITEKIT_GET_CLIENT_ID`

Tool to retrieve stored RiteKit client_id. Use when child actions require the client_id query parameter.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | No | Optional RiteKit API client ID. If not provided, the action attempts to read from connection metadata using keys: 'client_id', 'clientId', or 'client-id'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### RiteKit Get Client Secret

**Slug:** `RITEKIT_GET_CLIENT_SECRET`

Tool to retrieve stored RiteKit client_secret. Use when child actions require the client_secret parameter.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_secret` | string | No | Optional RiteKit API client secret. If not provided, the action attempts to read from connection metadata using keys: 'client_secret', 'clientSecret', or 'client-secret'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Full Email Insights

**Slug:** `RITEKIT_GET_FULL_EMAIL_INSIGHTS`

Tool to retrieve comprehensive email address insights including full name, free mail detection, business email detection, and typo suggestions. Use when you need detailed analysis of an email address for lead qualification or email validation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to analyze for detailed insights including full name, free mail detection, business email detection, and typo suggestions |
| `client_id` | string | No | RiteKit API client ID. If not provided, will be read from connection metadata |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### RiteKit Hashtag Suggestions

**Slug:** `RITEKIT_HASHTAG_SUGGESTIONS`

Tool to get hashtag suggestions for a given text. Use when you need relevant hashtags for social media posts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `text` | string | Yes | Input text or single word (1–1000 characters) to get hashtag suggestions |
| `client_id` | string | No | Client ID for authentication; required if access_token is not provided |
| `access_token` | string | No | OAuth2 access token; required if client_id is not provided |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Link Ad

**Slug:** `RITEKIT_LINK_AD_DELETE`

Tool to delete a link ad. Use when you need to permanently remove a link ad by its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the link ad to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Link Ads

**Slug:** `RITEKIT_LIST_LINK_ADS`

Tool to retrieve a list of link ads. Use after authenticating to fetch all link ads for the user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | No | RiteKit API client ID; optional if using OAuth access_token |
| `access_token` | string | No | OAuth2 access token; optional if using client_id |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Shorten Link

**Slug:** `RITEKIT_SHORTEN_LINK`

Tool to shorten a URL with a specified CTA. Use when you need to generate a call-to-action-enabled short link.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cta` | integer | Yes | ID of the call-to-action to attach to the shortened link |
| `url` | string | Yes | URL to be shortened |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Convert Text to Image

**Slug:** `RITEKIT_TEXT_TO_IMAGE`

Tool to convert a quote into a styled image. Use after preparing quote text and style options.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `quote` | string | Yes | Text of the quote to render as an image |
| `author` | string | No | Name of the author or source of the quote |
| `bgType` | string ("solid" | "gradient") | No | Background type: 'solid' or 'gradient' |
| `fontSize` | integer | No | Font size for the quote text (px, between 8 and 144) |
| `animation` | string ("none" | "rays" | "glint" | "circle") | No | Animation effect: none, rays, glint, or circle |
| `brandLogo` | string | No | URL of a brand logo to include |
| `client_id` | string | No | Optional RiteKit API client ID. If not provided, the action attempts to read from connection metadata |
| `quoteFont` | string | No | Font family for the quote text |
| `authorFont` | string | No | Font family for the author text |
| `gradientType` | string ("linear" | "radial") | No | Gradient type when bgType is 'gradient' |
| `showQuoteMark` | integer ("0" | "1") | No | Display quote mark (1 = yes, 0 = no) |
| `gradientColor1` | string | No | First color for gradient background |
| `gradientColor2` | string | No | Second color for gradient background |
| `highlightColor` | string | No | Color (hex or name) for highlight |
| `quoteFontColor` | string | No | Color (hex or name) for the quote text |
| `authorFontColor` | string | No | Color (hex or name) for the author text |
| `backgroundColor` | string | No | Background color for solid type |
| `enableHighlight` | integer ("0" | "1") | No | Highlight behind quote text (1 = yes, 0 = no) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |