Quickstart

npm install @relayapi/sdk

pip install relay

go get github.com/relayapi-dev/relay-go

# Gradle
implementation("dev.relayapi:relay-java:0.0.1")

# No installation needed — use curl directly

import Relay from '@relayapi/sdk';

const client = new Relay(); // reads RELAY_API_KEY from environment

from relay import Relay

client = Relay()  # reads RELAY_API_KEY from environment

import relaygo "github.com/relayapi-dev/relay-go"

client := relaygo.NewClient() // reads RELAY_API_KEY from environment

import dev.relayapi.api.client.RelayClient;
import dev.relayapi.api.client.okhttp.RelayOkHttpClient;

RelayClient client = RelayOkHttpClient.fromEnv(); // reads RELAY_API_KEY from environment

# Set your API key as an environment variable
export RELAY_API_KEY="rlay_live_your_api_key"

const flow = await client.connect.startOAuthFlow('twitter');
// Redirect user to flow.auth_url to authorize

flow = client.connect.start_oauth_flow('twitter')
# Redirect user to flow.auth_url to authorize

flow, err := client.Connect.StartOAuthFlow(context.TODO(), "twitter", relaygo.ConnectStartOAuthFlowParams{})
// Redirect user to flow.AuthURL to authorize

ConnectStartOAuthFlowResponse flow = client.connect().startOAuthFlow("twitter");
// Redirect user to flow.authUrl() to authorize

curl https://api.relayapi.dev/v1/connect/twitter \
  -H "Authorization: Bearer $RELAY_API_KEY"

const post = await client.posts.create({
  content: 'Hello from RelayAPI!',
  targets: ['twitter', 'linkedin'],
  scheduled_at: 'now',
});

console.log(post.id);     // "post_abc123"
console.log(post.status); // "published"

post = client.posts.create(
    content='Hello from RelayAPI!',
    targets=['twitter', 'linkedin'],
    scheduled_at='now',
)

print(post.id)      # "post_abc123"
print(post.status)  # "published"

post, err := client.Posts.New(context.TODO(), relaygo.PostNewParams{
    Content:     relaygo.F("Hello from RelayAPI!"),
    Targets:     relaygo.F([]string{"twitter", "linkedin"}),
    ScheduledAt: relaygo.F("now"),
})

fmt.Println(post.ID)     // "post_abc123"
fmt.Println(post.Status) // "published"

PostCreateResponse post = client.posts().create(PostCreateParams.builder()
    .content("Hello from RelayAPI!")
    .addTarget("twitter")
    .addTarget("linkedin")
    .scheduledAt("now")
    .build());

System.out.println(post.id());     // "post_abc123"
System.out.println(post.status()); // "published"

curl -X POST https://api.relayapi.dev/v1/posts \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from RelayAPI!",
    "targets": ["twitter", "linkedin"],
    "scheduled_at": "now"
  }'

const post = await client.posts.create({
  content: 'Scheduled post!',
  targets: ['twitter'],
  scheduled_at: '2024-01-16T12:00:00',
  timezone: 'America/New_York',
});

post = client.posts.create(
    content='Scheduled post!',
    targets=['twitter'],
    scheduled_at='2024-01-16T12:00:00',
    timezone='America/New_York',
)

post, err := client.Posts.New(context.TODO(), relaygo.PostNewParams{
    Content:     relaygo.F("Scheduled post!"),
    Targets:     relaygo.F([]string{"twitter"}),
    ScheduledAt: relaygo.F("2024-01-16T12:00:00"),
    Timezone:    relaygo.F("America/New_York"),
})

PostCreateResponse post = client.posts().create(PostCreateParams.builder()
    .content("Scheduled post!")
    .addTarget("twitter")
    .scheduledAt("2024-01-16T12:00:00")
    .timezone("America/New_York")
    .build());

curl -X POST https://api.relayapi.dev/v1/posts \
  -H "Authorization: Bearer $RELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Scheduled post!",
    "targets": ["twitter"],
    "scheduled_at": "2024-01-16T12:00:00",
    "timezone": "America/New_York"
  }'