Skip to content
Axway Logo
  • Products
    • Amplify API Management Platform
    • Amplify Enterprise Marketplace
    • B2B Integration
    • Financial Accounting Hub
    • Managed File Transfer
    • Managed Cloud Services
    • Open Banking
    • Specialized Products
    • Pricing
  • Solutions

      Find out how our solutions, solve problems while saving time and money:

    • By Industry
    • By Product
    • By Initiative

      By Industry

    • Banking & Financial Services
    • Government & Public Service
    • Healthcare
    • Life Sciences
    • Insurance
    • Energy and Utilities
    • Retail
    • Transportation & Logistics
    • Manufacturing and CPG
    • Telecommunications

      By Product

      API Management

    • API Discovery, adoption, and reuse
    • Event-enable your enterprise
    • Manage complexity
    • B2B/EDI Integration

    • Move B2B to cloud
    • Managed File Transfer (MFT)

    • Move MFT to cloud
    • Self-service MFT

      By Initiative

    • Deliver real-time data with EDA
    • Reach new markets
    • Improve customer experience
    • Secure file transfers for digital experiences
    • See All Industries, Products & Use Cases

      Find out how we have solved business challenges with your industry or use case.

  • Our Customers
    • Customer Advocacy
  • Experts
    • Catalyst Specialists
    • Training & Certification
    • Consulting Services
    • Griffin Innovation Lab
  • About Us
    • Careers
    • Leadership
    • Investor Relations
    • Newsroom
    • Legal Contracts
    • Locations
  • Support
    • Getting started
    • Axway Community
    • Documentation
    • Contact Support
    • User Group Program
    • Axway Security Statement
    • Developer Portal
    • Videos
  • Resources
    • Analysts Reports
    • Axway University
    • Resource Center
    • Blogs
    • Events
    • Webinars
  • Partners
    • Find a partner
    • Become a partner
    • Partner Resources
  • Contact
  • Login
    • Customer
    • Partner
  • Legal Contracts
  • Sitemap
  • Axway Blog
  • Learning Center
    • APIs
      • The Basics
      • Enterprise API Strategy
      • API Trends
      • API Management
      • Streaming
    • Software Development
    • Cloud Adoption
    • Digital Security
      • Keys and OAuth
      • Proxy and Gateway
      • Microgateway
      • Risk Management
      • Cyberthreats
    • Digital Strategy
      • API-First
      • Cloud-First
      • Digital Transformation
    • EDI and B2B Integration
    • Managed File Transfer (MFT)
  • Industry Insights
    • Automotive
    • Banking and Finance
    • Energy and Utilities
    • Government and Public Sector
    • Healthcare and Life Sciences
    • Retail
    • Transportation and Logistics
  • Product Insights
    • Amplify API Management Platform
      • Amplify
      • Agents
      • Application Integration
      • API Builder
      • Central
      • Catalog
      • Enterprise Marketplace
      • Streams
    • Axway B2B Integration
      • Managed Cloud: B2B
    • Digital Finance
    • Axway Managed File Transfer
      • Managed Cloud: MFT
      • Flow Manager
      • Operational Intelligence for MFT
      • SecureTransport
      • Syncplicity
    • Axway Open Banking
    • Specialized Products
      • Track & Trace
      • Verification Router Service
    • Discontinued Products
      • Appcelerator
      • Titanium
  • Life at Axway
    • Customer Experience
    • Company Events
    • Employee Spotlights
    • Partners
    • Newsroom
Axway Blog > Product Insights > Axway Managed File Transfer > Syncplicity > Getting started with Syncplicity REST APIs: Part 1

Table of Contents

  • Syncplicity REST APIs
  • Note for EU users
  • Getting your OAuth tokens
  • Postman
Syncplicity

Getting started with Syncplicity REST APIs: Part 1

April 17, 2020 |
Syncplicity REST APIs

Share this article:

  • Facebook
  • Twitter
  • LinkedIn

Getting started with the Syncplicity REST APIs is simple. I created this “cheat sheet” so that you can get started quickly. You can begin by logging in to the Syncplicity Developer Portal using your Syncplicity Enterprise Account email address. (Click here for the US-based portal or for the EU-based portal.)

Syncplicity REST APIs

You’ll need to have an “Owner” or “Global Admin” role in Syncplicity in order to log in to the Developer Portal.

The Developer Portal will prompt you to create a password for your sandbox account. Once you’re logged in, you’ll have access to the REST API documentation and examples.

The sandbox account is a fully functional Syncplicity Enterprise Account, allowing you to manage users, set Policies and access all the features and administration options of Syncplicity. The owner of this account will be named using your email address but with a “-apidev” added before the at sign (@).

Note for EU users

This document uses US-based information in the examples and contents namely:

  • The Developer Portal.
  • The base Fully Qualified Domain Name (FQDN) for API calls.

For EU-based users or those users whose accounts or information exist in the Syncplicity European Privacy Region, please replace the above references with the following instead:

  • The Developer Portal—replace syncplicity.com (US) with developer.eu.syncplicity.com (EU).
  • The base Fully Qualified Domain Name (FQDN) for API calls–replace syncplicity.com (US) with api.eu.syncplicity.com (EU).

Getting your OAuth tokens

To use the APIs, you need to be authenticated with the correct OAuth tokens for your REST API requests.

First, get the base64 encoded OAuth basic token for your App at:

  • The Developer Portal, log in, go to the “Applications” tab, select the application, get the “Client ID,” select the “Actions” link, select “View Secret” and get the “”
    • The Client ID looks something like this: 8dVbWYAA0ptx3bD1Syr77JEERI9XwlqY
    • The Secret looks something like this: P9J6ocLOsWCp2X4c
    • If you don’t have them here, create a new App and they’ll be generated for you.
  • To use the Client ID and Secret, you need to base64 encode them together.  There are a couple of ways to do this:
    • Go Base64 Encode Org and paste in “<Client ID>:<Secret>”
    • From a Linux Shell, type in:
      • echo -n “<Client ID>:<Secret>” | base64
    • Either way, save this base64 encoded string somewhere safe!
      • The base64 encoded string will look something like this:  OGRWYldZQUEwcHR4M2JEMVN5cjc3SkVFUkk5WHdscVk6UDlKNm9jTE9zV0NwMlg0Yw==
    • NOTE: don’t forget to include the colon (:) between the Key and Secret when performing the above.

Second, get the Syncplicity Application Token for your account:

  • Login to your Syncplicity Admin Account, go to your Account tab and find the “Application Token” under your Profile info.
    • If it’s not there, click the “Create” link to create one.
    • Save this token string somewhere safe!

Now you’ve got the two parts you need to use the APIs. To get logged in with OAuth and retrieve your “Bearer token,” perform the following API request:

  • URI:
    • https://api.syncplicity.com/oauth/token
  • Action:
    • POST
  • Headers:
    • ‘Authorization: Basic <base64 string from above>’
    • ‘Sync-App-Token: <Application Token from above>’
  • Data:
    • ‘grant_type=client_credentials’

You’ll receive back a bunch of stuff, including the Access Token (also known as a Bearer Token) and Company ID, which you’ll need for your later API calls.

cURL

If you’re a cURL person, the above translates to:

curl -sS -X POST https://api.syncplicity.com/oauth/token -H ‘Authorization: Basic <base64string>’ -H ‘Sync-App-Token: <TokenString>’ -d ‘grant_type=client_credentials’

What you’ll get back is something like this:

{
“issued_at”:”1457653432956”,
“scope”:”readwrite read”,
“user_company_id”:”8c1212c9-1e54-4ce1-b9fd-6f826f2582c3”,
“expires_in”:”5099”,
“user_email”:””,
“organization_id”:”0”,
“token_type”:”BearerToken”,
“client_id”:”WdVRG3ak9CS717BTgZiLZMxYAFTW2sfW”,
“access_token”:”OJnEotf5AhWpM3qsumDG3O8YpBIW”,
“organization_name”:”syncplicity”,
“application_id”:”58497e23-b3cb-4f17-a6e7-e25cca808214”
}

Now you’ve got the Company ID and, more importantly, the Access Token (in green), which is what you’ll need for all your API calls.

Postman

For Postman, enter the above components (URI, Action, Headers, data) into the Postman UI fields:

  • Enter request URL = URI from above.
  • Select POST for the request type.
  • Under the Headers tab, enter the Key and Value pairs = Headers from above.
  • Under the Body tab, select Raw = Data from above, without the single quotes.

Next step, go play in the Developer Portal! Using the above, you can now invoke all the other Syncplicity APIs and perform many Syncplicity actions and capabilities.

Don’t forget that you can always go to the Axway community to ask for help or assistance with the Syncplicity APIs. Enjoy!

Click Here

Share this article:

  • Facebook
  • Twitter
  • LinkedIn

Read more articles and resources

Post navigation

GA Release of Titanium SDK 9.0.1
Axway + Solace Part 1: Getting Started with Solace

Tags

developer portalOAuthSyncplicity Enterprise Account

The future of API Management
platforms is open

Axway
  • Products
    • Amplify API Management Platform
    • Amplify Enterprise Marketplace
    • B2B Integration
    • Financial Accounting Hub
    • Managed File Transfer
    • Managed Cloud Services
    • Open Banking
    • Specialized Products
    • Pricing
  • Industries
    • Banking & Financial Services
    • Healthcare
    • Life Science
    • Other Industries
  • Our Customers
    • Customer Advocacy
  • Experts
    • Catalyst Specialists
    • Training & Certification
    • Consulting Services
    • Griffin Innovation Lab

  • About Us
  • Support
  • Resources
  • Partners
  • Contact
  • Login
  • Legal Contracts
  • Sitemap

Visit our Instagram page Visit our Facebook page Visit our SlideShare page Visit our LinkedIn page Visit our Twitter feed Visit our YouTube channel
AWS Partner Network
2021 Microsoft Gold partner