Entegrasyon Kılavuzu

Upload-Post + n8n Integration

Automate your social media publishing by connecting Upload-Post with n8n. Start by setting up your Upload-Post users and API key, then choose between our official n8n node or manual HTTP configuration.

Browse All n8n Templates

İş akışınızı oluştururken yardıma mı ihtiyacınız var? We work with trusted partners who can set up your n8n automation or build a custom project for you.

Bize ulaşın

Prerequisite: Setup in Upload-Post

Before configuring n8n, you must set up users and generate an API key within your Upload-Post account. These will be used to authenticate and direct your automated posts.

Kullanıcıları Yönet & Sosyal Hesapları Bağla

Each post is associated with a specific user in Upload-Post. This user must have the target social media platforms connected to their profile.

  • Navigate to the Kullanıcıları Yönet page in your Upload-Post dashboard.
  • Yeni bir kullanıcı ekleyin veya mevcut birini seçin.
  • Seçilen kullanıcı için, n8n üzerinden içerik yayınlamayı düşündüğünüz tüm sosyal medya hesaplarını (örneğin, TikTok, Instagram, Facebook) bağlayın.
  • Take note of the Kullanıcı Tanımlayıcı (this is typically the username or a unique ID associated with the user in Upload-Post). You will need this for your n8n workflows.

Önemli: Sosyal hesaplar, genel olarak Upload-Post hesabınıza değil, otomasyonunuzda kullanmayı planladığınız *belirli kullanıcıya* bağlanmalıdır.

API Anahtarı Oluştur

The API key authenticates your requests to the Upload-Post API.

  • Go to the API Anahtarları page in your Upload-Post API keys section.
  • Zaten bir API anahtarınız yoksa yeni bir tane oluşturun.
  • Bu API anahtarını güvenli bir şekilde kopyalayın. n8n kimlik bilgisi ayarınızda bunu kullanacaksınız.

Güvenlik Notu: Treat your API key like a password. Do not share it publicly or embed it directly in shared workflows. Use n8n\'s credential management system.

Once you have your Kullanıcı Tanımlayıcı and API Anahtarı from Upload-Post, you are ready to configure n8n.

Recommended: Using the Official Upload-Post n8n Node

Düğüm Mevcudiyeti:

The n8n-nodes-upload-post node is now included by default in updated versions of n8n for both self-hosted (on-premise) n8n instances and n8n cloud instances. No manual installation is required - just ensure you have the latest version of n8n.

The easiest way to integrate is using our official node: n8n-nodes-upload-post. This node is included by default in updated versions of n8n and streamlines setup with dedicated operations for both cloud and self-hosted n8n instances.

1. Access the Upload-Post Node

Upload-Post düğümü, n8n\'in güncellenmiş sürümlerinde varsayılan olarak dahildir:

  1. n8n\'in en son sürümünün yüklü olduğundan emin olun.
  2. n8n iş akışı editörünüzü açın.
  3. Düğüm kütüphanesinde "Upload Post" için ara.
  4. Düğüm, ek bir kurulum olmadan kullanılabilir olmalıdır.

If you don\'t see the node, please update your n8n instance to the latest version.

2. Configure Upload-Post API Credentials in n8n

You\'ll use the API Key generated from your Gönderi API\'si Bölümü (as described in the "Prerequisite" section above).

  1. In n8n, go to Kimlik Bilgileri > Yeni.
  2. Search for Gönderi API\'sini Yükle ve seçin.
  3. Assign a memorable Kimlik Bilgisi Adı (e.g., "My Upload-Post API Key").
  4. Upload Post API Anahtarı belirlenen alana.
  5. Click Kaydet.

Bu, Upload-Post düğümü tarafından kullanılmak üzere API anahtarınızı güvenli bir şekilde saklar.

3. Utilize Node Operations in Your İş Akışları

The node provides dedicated operations. For each, you will need to provide the Kullanıcı Tanımlayıcı (from the user you set up in Upload-Post Kullanıcıları Yönet) to specify which user\'s social accounts to use.

Fotoğraf(lar) Yükle

Bir veya daha fazla fotoğraf yükleyin. Dosya veya URL kabul eder.

Gerekli: User Identifier, Platform(s), Photos. İsteğe bağlı: Title, Caption. Platform-specific fields available.

Video Yükle

Tek bir video yükleyin. Dosya veya URL kabul eder.

Gerekli: User Identifier, Platform(s), Video. İsteğe bağlı: Title. Platform-specific fields available.

Metin Yükle

Metin tabanlı bir gönderi yükleyin.

Gerekli: User Identifier, Platform(s), Title/Content. Platform-specific fields available.

Refer to the node\'s help documentation within n8n or the npm package page for detailed parameter lists. The Gönderi API\'si Dokümantasyonu provides full details on underlying API capabilities.

Using this dedicated n8n node is the recommended approach for both cloud and self-hosted n8n users.

Manual Configuration (Alternative using HTTP Request Node)

If the official node is not suitable for your specific needs, you can configure the integration manually using n8n\'s generic HTTP Request node. This requires careful setup of API parameters.

Ön koşul: Upload-Post Kullanıcı & API Anahtarı

Bu kılavuzun başında açıklanan "Ön koşul: Upload-Post\'ta Kurulum" adımlarını tamamladığınızdan emin olun. İhtiyacınız olacak:

Open Upload-Post App

Upload-Post API Uç Noktalarını Anlamak ve İstek Yapmak

Upload-Post offers distinct API endpoints for uploading different types of content. All requests must include an Yetkilendirme header with your API Key and generally require a user field (your User Identifier from Upload-Post) and platform[] to specify the target social media.

1. Video Upload Endpoint

Uç Nokta URL: https://api.upload-post.com/api/upload

Use this endpoint for uploading single video files. Key parameters include video (file), title, user, and platform[].

curl \
  -H 'Yetkilendirme: Apikey YOUR_API_KEY_HERE' \
  -F 'video=@/path/to/your/video.mp4' \
  -F 'title="Video Başlığınız"' \
  -F 'user="KULLANICI_TANIMLAYICINIZ"' \
  -F 'platform[]=tiktok' \
  -X POST https://api.upload-post.com/api/upload

2. Photo Upload Endpoint

Uç Nokta URL: https://api.upload-post.com/api/upload_photos

For uploading one or more photos (e.g., for carousels/slideshows). Use photos[] for each image file. Also include user, platform[], title, and optionally description.

curl \
  -H 'Yetkilendirme: Apikey YOUR_API_KEY_HERE' \
  -F 'photos[]=@/path/to/your/image1.jpg' \
  -F 'photos[]=@/path/to/your/image2.webp' \
  -F 'user="KULLANICI_TANIMLAYICINIZ"' \
  -F 'platform[]=instagram' \
  -F 'title="My Awesome Photo Album"' \
  -F 'description="Check out these cool photos!"' \
  -X POST https://api.upload-post.com/api/upload_photos

3. Text Upload Endpoint

Uç Nokta URL: https://api.upload-post.com/api/upload_text

For publishing text-based posts. Requires user, platform[], and title (as the main content). caption can be used for internal tracking or specific platform needs.

curl \
  -H 'Yetkilendirme: Apikey YOUR_API_KEY_HERE' \
  -F 'user="KULLANICI_TANIMLAYICINIZ"' \
  -F 'platform[]=x' \
  -F 'title="This is my amazing tweet content!"' \
  -F 'caption="Optional: A caption for stats & tracking."' \
  -X POST https://api.upload-post.com/api/upload_text

Manuel Konfigürasyon için Önemli Notlar:

  • Replace BURAYA_API_ANAHTARINIZI_YAZIN with your actual API key from the Upload-Post Api section.
  • Replace KULLANICI_TANIMLAYICINIZ hedef sosyal medya hesaplarının bağlı olduğu Upload-Post\'taki belirli Kullanıcı Tanımlayıcı (örn. kullanıcı adı) ile değiştirin.
  • API anahtarınızı n8n\'in kimlik bilgisi yöneticisinde saklamanız ve bunu HTTP İsteği düğümünüzde sabit kodlama yerine referans almanız şiddetle önerilir.
  • The @/path/to/your/file syntax in cURL indicates a file upload. In n8n, you would use expressions to reference binary data from previous nodes (e.g., ={{ $binary.data }}).

Profesyonel İpucu: Upload-Post Kontrol Panelinden cURL\'ü Test Et ve Oluştur

Before configuring n8n, test your uploads directly from the Upload-Post Kontrol Paneli. Once you\'ve successfully uploaded content, the dashboard generates a perfect cURL command that you can copy and import directly into your n8n HTTP Request node.

İş Akışı:

  1. Go to Upload-Post Kontrol Paneli
  2. İçeriğinizi (video, fotoğraflar veya metin) istediğiniz platformlara yükleyin
  3. Başarılı yüklemeden sonra, oluşturulan cURL komutunu kopyalayın
  4. Bu cURL\'ü doğrudan n8n HTTP İstek düğümünüze "cURL\'den İçe Aktar" özelliğini kullanarak içe aktarın

n8n HTTP İsteği Düğümünü (Gövde) yapılandırın

Key fields for the HTTP Request node\'s body (typically multipart/form-data):

Alan Değer / Açıklama Gerekli
user Your Kullanıcı Tanımlayıcı from Upload-Post (e.g., username). Gerekli
platform[] Platform tanımlayıcı (örn. tiktok, instagram). Repeat for multiple platforms. Gerekli
title Başlık veya içerik gönder (platforma ve gönderi türüne göre değişir). İsteğe bağlı/Farklılık gösterir
video Video yüklemeleri için ikili dosya verisi. Video yüklüyorsanız
image[] Görüntü yüklemeleri için ikili dosya verisi. Bir karusel/slayt gösterisinde birden fazla görüntü için tekrarlayın. Görsel(ler) yüklüyorsanız
n8n Configuration Tips:
  • Set HTTP Request node Yöntem to POST.
  • Set URL to https://api.upload-post.com/api/upload.
  • Add the Yetkilendirme header with your API key.
  • For Gövde İçerik Türü, select multipart/form-data.
  • Body\'ye şu gibi alanlar ekleyin user, platform[], title, and either video or image[] with appropriate values (e.g., using n8n expressions like ={{ $binary.data }} for file data).

For detailed examples and platform-specific parameters, refer to the Gönderi API\'si Dokümantasyonu.

Örnek: HTTP Düğümü JSON (Video\'dan TikTok\'a)

This is a conceptual JSON representation for an n8n HTTP Request node configured to upload a video to TikTok. You would build this using the n8n interface. 

{
  "parameters": {
    "method": "POST",
    "url": "https://api.upload-post.com/api/upload",
    "authentication": "headerAuth",
    "sendHeaders": true,
    "headerParameters": {
      "parameters": [
        {
          "name": "Yetkilendirme",
          "value": "Apikey YOUR_API_KEY_HERE"
        }
      ]
    },
    "sendBody": true,
    "bodyContentType": "multipart-form-data",
    "bodyParameters": {
      "parameters": [
        {
          "name": "user",
          "value": "YOUR_UPLOAD_POST_USER_IDENTIFIER"
        },
        {
          "name": "title",
          "value": "= $input.item.title ? $input.item.title : 'Harika videom'"
        },
        {
          "name": "platform[]",
          "value": "tiktok"
        }
      ]
    },
    "formBinaryData": {
      "video": "={{ $binary.data }}"
    },
    "options": {}
  },
  "name": "Videoyu TikTok'a Yükle (Manuel)",
  "type": "n8n-nodes-base.httpRequest"
}

Crucial: API Keys & User Identifiers

  • API Anahtarı Güvenliği: Always use n8n\'s credential management for your Upload-Post API Key. Avoid hardcoding it.
  • Kullanıcı Tanımlayıcı: İstek gövdenizdeki user alanının, kullanmayı planladığınız bağlı sosyal hesaplara sahip Upload-Post\'taki Kullanıcı Tanımlayıcıyı doğru şekilde referans aldığından emin olun.
  • İş akışlarını paylaşırken, hassas kimlik bilgisi verileri olmadan dışa aktarın.

Örnek İş Akışı: AI destekli Sosyal Medya Yayıncısı

This workflow is available as a template: n8n.io\'da görüntüle or see all our n8n templates

What It Does

  • Yeni videolar için bir Google Drive klasörünü izler
  • Videoyu OpenAI kullanarak transkribe eder
  • Etkileyici sosyal medya açıklamaları oluşturur
  • Instagram, TikTok ve YouTube\'a Yüklemeler
  • Tamamlandığında veya hatalarda bildirim gönderir

Workflow Architecture

n8n Workflow Architecture

Implementation Steps

  1. Google Drive Tetikleyici: Configure to monitor a specific folder for new videos
  2. OpenAI Transkripsiyonu: Set up to extract audio and convert to text
  3. OpenAI Açıklama Üretici: Use a custom prompt to create engaging descriptions based on transcription
  4. Upload-Post HTTP İsteği: Configure as described in previous steps with multi-platform selection
  5. Hata Yönetimi: Add Telegram notification for success/failure alerts
Get This Template on n8n.io

Örnek İş Akışı: Instagram ve TikTok için Görsel Karusel Yayıncısı

This workflow is available as a template: n8n.io\'da görüntüle or see all our n8n templates

What It Does

  • Birden fazla resmi Instagram\'a karusel olarak yüklemeyi otomatikleştirir.
  • Birden fazla resmi TikTok\'a slayt gösterisi olarak yüklemeyi otomatikleştirir.
  • Görsel içerik yönetimini platformlar arasında kolaylaştırır
  • Tek bir tetikleyici ile çoklu görsel yüklemelerini yönetir

Workflow Steps

  1. Tetikleyici: Start the workflow with your selected images (e.g., from a schedule, webhook, or manual execution).
  2. Görsel İşleme: The workflow prepares images for platform-specific formats (consider nodes for resizing or formatting if needed).
  3. Upload-Post HTTP İsteği: Configure an HTTP Request node (similar to the video upload) but adjust for image uploads.
    • `video` yerine `image[]` alanını kullanın.
    • Her resim için ikili veriyi `image[]` alanına iletin.
    • `platform[]`'u `instagram` ve/veya `tiktok` olarak ayarlayın.
  4. Platform Optimizasyonu: Upload-Post handles formatting according to each platform\'s requirements (carousel for Instagram, slideshow for TikTok).
  5. (Optional) Notifications: Add nodes to notify upon success or failure.

Refer to the n8n template for specific node configurations, especially for handling multiple image inputs.

Get This Template on n8n.io

Yardım mı gerekiyor?

Entegrasyon uzmanlarımız burada yardımcı olmak için var

Contact Support